This documentation is for the developer preview release of the AWS CDK. Do not use this version of the AWS CDK in production. Subsequent releases of the AWS CDK will likely include breaking changes.

@aws-cdk/aws-ec2

AWS Compute and Networking Construct Library

The @aws-cdk/aws-ec2 package contains primitives for setting up networking and instances.

VPC

Most projects need a Virtual Private Cloud to provide security by means of network partitioning. This is easily achieved by creating an instance of VpcNetwork:

import ec2 = require('@aws-cdk/aws-ec2');

const vpc = new ec2.VpcNetwork(this, 'VPC');

All default Constructs requires EC2 instances to be launched inside a VPC, so you should generally start by defining a VPC whenever you need to launch instances for your project.

Our default VpcNetwork class creates a private and public subnet for every availability zone. Classes that use the VPC will generally launch instances into all private subnets, and provide a parameter called vpcPlacement to allow you to override the placement. Read more about subnets.

Advanced Subnet Configuration

If you require the ability to configure subnets the VpcNetwork can be customized with SubnetConfiguration array. This is best explained by an example:

import ec2 = require('@aws-cdk/aws-ec2');

const vpc = new ec2.VpcNetwork(stack, 'TheVPC', {
  cidr: '10.0.0.0/21',
  subnetConfiguration: [
    {
      cidrMask: 24,
      name: 'Ingress',
      subnetType: SubnetType.Public,
    },
    {
      cidrMask: 24,
      name: 'Application',
      subnetType: SubnetType.Private,
    },
    {
      cidrMask: 28,
      name: 'Database',
      subnetType: SubnetType.Isolated,
    }
  ],
});

The example above is one possible configuration, but the user can use the constructs above to implement many other network configurations.

The VpcNetwork from the above configuration in a Region with three availability zones will be the following:

  • IngressSubnet1: 10.0.0.0/24
  • IngressSubnet2: 10.0.1.0/24
  • IngressSubnet3: 10.0.2.0/24
  • ApplicationSubnet1: 10.0.3.0/24
  • ApplicationSubnet2: 10.0.4.0/24
  • ApplicationSubnet3: 10.0.5.0/24
  • DatabaseSubnet1: 10.0.6.0/28
  • DatabaseSubnet2: 10.0.6.16/28
  • DatabaseSubnet3: 10.0.6.32/28

Each Public Subnet will have a NAT Gateway. Each Private Subnet will have a route to the NAT Gateway in the same availability zone. Each Isolated subnet will not have a route to the internet, but is routeable inside the VPC. The numbers [1-3] will consistently map to availability zones (e.g. IngressSubnet1 and ApplicationSubnet1 will be in the same avialbility zone).

Isolated Subnets provide simplified secure networking principles, but come at an operational complexity. The lack of an internet route means that if you deploy instances in this subnet you will not be able to patch from the internet, this is commonly reffered to as fully baked images. Features such as cfn-signal are also unavailable. Using these subnets for managed services (RDS, Elasticache, Redshift) is a very practical use because the managed services do not incur additional operational overhead.

Many times when you plan to build an application you don’t know how many instances of the application you will need and therefore you don’t know how much IP space to allocate. For example, you know the application will only have Elastic Loadbalancers in the public subnets and you know you will have 1-3 RDS databases for your data tier, and the rest of the IP space should just be evenly distributed for the application.

import ec2 = require('@aws-cdk/aws-ec2');

const vpc = new ec2.VpcNetwork(stack, 'TheVPC', {
  cidr: '10.0.0.0/16',
  natGateways: 1,
  subnetConfiguration: [
    {
      cidrMask: 26,
      name: 'Public',
      subnetType: SubnetType.Public,
    },
    {
      name: 'Application',
      subnetType: SubnetType.Private,
    },
    {
      cidrMask: 27,
      name: 'Database',
      subnetType: SubnetType.Isolated,
    }
  ],
});

The VpcNetwork from the above configuration in a Region with three availability zones will be the following:

  • PublicSubnet1: 10.0.0.0/26
  • PublicSubnet2: 10.0.0.64/26
  • PublicSubnet3: 10.0.2.128/26
  • DatabaseSubnet1: 10.0.0.192/27
  • DatabaseSubnet2: 10.0.0.224/27
  • DatabaseSubnet3: 10.0.1.0/27
  • ApplicationSubnet1: 10.0.64.0/18
  • ApplicationSubnet2: 10.0.128.0/18
  • ApplicationSubnet3: 10.0.192.0/18

Any subnet configuration without a cidrMask will be counted up and allocated evenly across the remaining IP space.

Teams may also become cost conscious and be willing to trade availability for cost. For example, in your test environments perhaps you would like the same VPC as production, but instead of 3 NAT Gateways you would like only 1. This will save on the cost, but trade the 3 availability zone to a 1 for all egress traffic. This can be accomplished with a single parameter configuration:

import ec2 = require('@aws-cdk/aws-ec2');

const vpc = new ec2.VpcNetwork(stack, 'TheVPC', {
  cidr: '10.0.0.0/16',
  natGateways: 1,
  natGatewayPlacement: {subnetName: 'Public'},
  subnetConfiguration: [
    {
      cidrMask: 26,
      name: 'Public',
      subnetType: SubnetType.Public,
      natGateway: true,
    },
    {
      name: 'Application',
      subnetType: SubnetType.Private,
    },
    {
      cidrMask: 27,
      name: 'Database',
      subnetType: SubnetType.Isolated,
    }
  ],
});

The VpcNetwork above will have the exact same subnet definitions as listed above. However, this time the VPC will have only 1 NAT Gateway and all Application subnets will route to the NAT Gateway.

Sharing VPCs across stacks

If you are creating multiple Stacks inside the same CDK application, you can reuse a VPC defined in one Stack in another by using export() and import():

class Stack1 extends cdk.Stack {
  public readonly vpcProps: ec2.VpcNetworkRefProps;

  constructor(parent: cdk.App, id: string, props?: cdk.StackProps) {
    super(parent, id, props);

    const vpc = new ec2.VpcNetwork(this, 'VPC');

    // Export the VPC to a set of properties
    this.vpcProps = vpc.export();
  }
}

interface Stack2Props extends cdk.StackProps {
  vpcProps: ec2.VpcNetworkRefProps;
}

class Stack2 extends cdk.Stack {
  constructor(parent: cdk.App, id: string, props: Stack2Props) {
    super(parent, id, props);

    // Import the VPC from a set of properties
    const vpc = ec2.VpcNetworkRef.import(this, 'VPC', props.vpcProps);

    new ConstructThatTakesAVpc(this, 'Construct', {
      vpc
    });
  }
}

const stack1 = new Stack1(app, 'Stack1');
const stack2 = new Stack2(app, 'Stack2', {
  vpcProps: stack1.vpcProps
});

If your VPC is created outside your CDK app, you can use importFromContext():

const vpc = ec2.VpcNetworkRef.importFromContext(stack, 'VPC', {
  // This imports the default VPC but you can also
  // specify a 'vpcName' or 'tags'.
  isDefault: true
});

Allowing Connections

In AWS, all network traffic in and out of Elastic Network Interfaces (ENIs) is controlled by Security Groups. You can think of Security Groups as a firewall with a set of rules. By default, Security Groups allow no incoming (ingress) traffic and all outgoing (egress) traffic. You can add ingress rules to them to allow incoming traffic streams. To exert fine-grained control over egress traffic, set allowAllOutbound: false on the SecurityGroup, after which you can add egress traffic rules.

You can manipulate Security Groups directly:

const mySecurityGroup = new ec2.SecurityGroup(this, 'SecurityGroup', {
  vpc,
  description: 'Allow ssh access to ec2 instances',
  allowAllOutbound: true   // Can be set to false
});
mySecurityGroup.addIngressRule(new ec2.AnyIPv4(), new ec2.TcpPort(22), 'allow ssh access from the world');

All constructs that create ENIs on your behalf (typically constructs that create EC2 instances or other VPC-connected resources) will all have security groups automatically assigned. Those constructs have an attribute called connections, which is an object that makes it convenient to update the security groups. If you want to allow connections between two constructs that have security groups, you have to add an Egress rule to one Security Group, and an Ingress rule to the other. The connections object will automatically take care of this for you:

// Allow connections from anywhere
loadBalancer.connections.allowFromAnyIpv4(new ec2.TcpPort(443), 'Allow inbound HTTPS');

// The same, but an explicit IP address
loadBalancer.connections.allowFrom(new ec2.CidrIpv4('1.2.3.4/32'), new ec2.TcpPort(443), 'Allow inbound HTTPS');

// Allow connection between AutoScalingGroups
appFleet.connections.allowTo(dbFleet, new ec2.TcpPort(443), 'App can call database');

Connection Peers

There are various classes that implement the connection peer part:

// Simple connection peers
let peer = new ec2.CidrIp("10.0.0.0/16");
let peer = new ec2.AnyIPv4();
let peer = new ec2.CidrIpv6("::0/0");
let peer = new ec2.AnyIPv6();
let peer = new ec2.PrefixList("pl-12345");
fleet.connections.allowTo(peer, new ec2.TcpPort(443), 'Allow outbound HTTPS');

Any object that has a security group can itself be used as a connection peer:

// These automatically create appropriate ingress and egress rules in both security groups
fleet1.connections.allowTo(fleet2, new ec2.TcpPort(80), 'Allow between fleets');

fleet.connections.allowTcpPort(80), 'Allow from load balancer');

Port Ranges

The connections that are allowed are specified by port ranges. A number of classes provide the connection specifier:

new ec2.TcpPort(80)
new ec2.TcpPortRange(60000, 65535)
new ec2.TcpAllPorts()
new ec2.AllConnections()
NOTE: This set is not complete yet; for example, there is no library support for ICMP at the moment. However, you can write your own classes to implement those.

Default Ports

Some Constructs have default ports associated with them. For example, the listener of a load balancer does (it’s the public port), or instances of an RDS database (it’s the port the database is accepting connections on).

If the object you’re calling the peering method on has a default port associated with it, you can call allowDefaultPortFrom() and omit the port specifier. If the argument has an associated default port, call allowToDefaultPort().

For example:

// Port implicit in listener
listener.connections.allowDefaultPortFromAnyIpv4('Allow public');

// Port implicit in peer
fleet.connections.allowToDefaultPort(rdsDatabase, 'Fleet can access database');

Machine Images (AMIs)

AMIs control the OS that gets launched when you start your EC2 instance. The EC2 library contains constructs to select the AMI you want to use.

Depending on the type of AMI, you select it a different way.

The latest version of Amazon Linux and Microsoft Windows images are selectable by instantiating one of these classes:

// Pick a Windows edition to use
const windows = new ec2.WindowsImage(ec2.WindowsVersion.WindowsServer2016EnglishNanoBase);

// Pick the right Amazon Linux edition. All arguments shown are optional
// and will default to these values when omitted.
const amznLinux = new ec2.AmazonLinuxImage({
  generation: ec2.AmazonLinuxGeneration.AmazonLinux,
  edition: ec2.AmazonLinuxEdition.Standard,
  virtualization: ec2.AmazonLinuxVirt.HVM,
  storage: ec2.AmazonLinuxStorage.GeneralPurpose,
});

// For other custom (Linux) images, instantiate a `GenericLinuxImage` with
// a map giving the AMI to in for each region:

const linux = new ec2.GenericLinuxImage({
    'us-east-1': 'ami-97785bed',
    'eu-west-1': 'ami-12345678',
    // ...
});

NOTE: The Amazon Linux images selected will be cached in your cdk.json, so that your AutoScalingGroups don’t automatically change out from under you when you’re making unrelated changes. To update to the latest version of Amazon Linux, remove the cache entry from the context section of your cdk.json.

We will add command-line options to make this step easier in the future.

Reference

View in Nuget

csproj:

<PackageReference Include="Amazon.CDK.AWS.EC2" Version="0.20.0" />

dotnet:

dotnet add package Amazon.CDK.AWS.EC2 --version 0.20.0

packages.config:

<package id="Amazon.CDK.AWS.EC2" version="0.20.0" />

View in Maven Central

Apache Buildr:

'software.amazon.awscdk:ec2:jar:0.20.0'

Apache Ivy:

<dependency groupId="software.amazon.awscdk" name="ec2" rev="0.20.0"/>

Apache Maven:

<dependency>
  <groupId>software.amazon.awscdk</groupId>
  <artifactId>ec2</artifactId>
  <version>0.20.0</version>
</dependency>

Gradle / Grails:

compile 'software.amazon.awscdk:ec2:0.20.0'

Groovy Grape:

@Grapes(
@Grab(group='software.amazon.awscdk', module='ec2', version='0.20.0')
)

View in NPM

npm:

$ npm i @aws-cdk/aws-ec2@0.20.0

package.json:

{
  "@aws-cdk/aws-ec2": "^0.20.0"
}

yarn:

$ yarn add @aws-cdk/aws-ec2@0.20.0

View in NPM

npm:

$ npm i @aws-cdk/aws-ec2@0.20.0

package.json:

{
  "@aws-cdk/aws-ec2": "^0.20.0"
}

yarn:

$ yarn add @aws-cdk/aws-ec2@0.20.0

AllTraffic

class @aws-cdk/aws-ec2.AllTraffic

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.AllTraffic;
const { AllTraffic } = require('@aws-cdk/aws-ec2');
import { AllTraffic } from '@aws-cdk/aws-ec2';

All Traffic

Implements:IPortRange
toRuleJSON() → any

Implements @aws-cdk/aws-ec2.IPortRange.toRuleJSON()

Produce the ingress/egress rule JSON for the given connection

Return type:any
toString() → string

Returns a string representation of an object.

Return type:string
canInlineRule

Implements @aws-cdk/aws-ec2.IPortRange.canInlineRule()

Whether the rule containing this port range can be inlined into a securitygroup or not.

Type:boolean (readonly)

AmazonLinuxEdition (enum)

class @aws-cdk/aws-ec2.AmazonLinuxEdition

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.AmazonLinuxEdition;
const { AmazonLinuxEdition } = require('@aws-cdk/aws-ec2');
import { AmazonLinuxEdition } from '@aws-cdk/aws-ec2';

Amazon Linux edition

Standard

Standard edition

Minimal

Minimal edition

AmazonLinuxGeneration (enum)

class @aws-cdk/aws-ec2.AmazonLinuxGeneration

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.AmazonLinuxGeneration;
const { AmazonLinuxGeneration } = require('@aws-cdk/aws-ec2');
import { AmazonLinuxGeneration } from '@aws-cdk/aws-ec2';

What generation of Amazon Linux to use

AmazonLinux

Amazon Linux

AmazonLinux2

Amazon Linux 2

AmazonLinuxImage

class @aws-cdk/aws-ec2.AmazonLinuxImage([props])

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.AmazonLinuxImage;
const { AmazonLinuxImage } = require('@aws-cdk/aws-ec2');
import { AmazonLinuxImage } from '@aws-cdk/aws-ec2';

Selects the latest version of Amazon Linux

The AMI ID is selected using the values published to the SSM parameter store.

Implements:IMachineImageSource
Parameters:props (AmazonLinuxImageProps (optional)) –
getImage(parent) → @aws-cdk/aws-ec2.MachineImage

Implements @aws-cdk/aws-ec2.IMachineImageSource.getImage()

Return the image to use in the given context

Parameters:parent (@aws-cdk/cdk.Construct) –
Return type:MachineImage

AmazonLinuxImageProps (interface)

class @aws-cdk/aws-ec2.AmazonLinuxImageProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.AmazonLinuxImageProps;
// AmazonLinuxImageProps is an interface
import { AmazonLinuxImageProps } from '@aws-cdk/aws-ec2';

Amazon Linux image properties

edition

What edition of Amazon Linux to use

Type:AmazonLinuxEdition (optional)
Default:Standard
generation

What generation of Amazon Linux to use

Type:AmazonLinuxGeneration (optional)
Default:AmazonLinux
storage

What storage backed image to use

Type:AmazonLinuxStorage (optional)
Default:GeneralPurpose
virtualization

Virtualization type

Type:AmazonLinuxVirt (optional)
Default:HVM

AmazonLinuxStorage (enum)

class @aws-cdk/aws-ec2.AmazonLinuxStorage

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.AmazonLinuxStorage;
const { AmazonLinuxStorage } = require('@aws-cdk/aws-ec2');
import { AmazonLinuxStorage } from '@aws-cdk/aws-ec2';
EBS

EBS-backed storage

GeneralPurpose

General Purpose-based storage (recommended)

AmazonLinuxVirt (enum)

class @aws-cdk/aws-ec2.AmazonLinuxVirt

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.AmazonLinuxVirt;
const { AmazonLinuxVirt } = require('@aws-cdk/aws-ec2');
import { AmazonLinuxVirt } from '@aws-cdk/aws-ec2';

Virtualization type for Amazon Linux

HVM

HVM virtualization (recommended)

PV

PV virtualization

AnyIPv4

class @aws-cdk/aws-ec2.AnyIPv4

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.AnyIPv4;
const { AnyIPv4 } = require('@aws-cdk/aws-ec2');
import { AnyIPv4 } from '@aws-cdk/aws-ec2';

Any IPv4 address

Extends:CidrIPv4
toEgressRuleJSON() → any

Inherited from @aws-cdk/aws-ec2.CidrIPv4

Produce the egress rule JSON for the given connection

Return type:any
toIngressRuleJSON() → any

Inherited from @aws-cdk/aws-ec2.CidrIPv4

Produce the ingress rule JSON for the given connection

Return type:any
canInlineRule

Inherited from @aws-cdk/aws-ec2.CidrIPv4

Whether the rule can be inlined into a SecurityGroup or not

Type:boolean (readonly)
cidrIp

Inherited from @aws-cdk/aws-ec2.CidrIPv4

Type:string (readonly)
connections

Inherited from @aws-cdk/aws-ec2.CidrIPv4

Type:Connections (readonly)
uniqueId

Inherited from @aws-cdk/aws-ec2.CidrIPv4

A unique identifier for this connection peer

Type:string (readonly)

AnyIPv6

class @aws-cdk/aws-ec2.AnyIPv6

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.AnyIPv6;
const { AnyIPv6 } = require('@aws-cdk/aws-ec2');
import { AnyIPv6 } from '@aws-cdk/aws-ec2';

Any IPv6 address

Extends:CidrIPv6
toEgressRuleJSON() → any

Inherited from @aws-cdk/aws-ec2.CidrIPv6

Produce the egress rule JSON for the given connection

Return type:any
toIngressRuleJSON() → any

Inherited from @aws-cdk/aws-ec2.CidrIPv6

Produce the ingress rule JSON for the given connection

Return type:any
canInlineRule

Inherited from @aws-cdk/aws-ec2.CidrIPv6

Whether the rule can be inlined into a SecurityGroup or not

Type:boolean (readonly)
cidrIpv6

Inherited from @aws-cdk/aws-ec2.CidrIPv6

Type:string (readonly)
connections

Inherited from @aws-cdk/aws-ec2.CidrIPv6

Type:Connections (readonly)
uniqueId

Inherited from @aws-cdk/aws-ec2.CidrIPv6

A unique identifier for this connection peer

Type:string (readonly)

CidrIPv4

class @aws-cdk/aws-ec2.CidrIPv4(cidrIp)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.CidrIPv4;
const { CidrIPv4 } = require('@aws-cdk/aws-ec2');
import { CidrIPv4 } from '@aws-cdk/aws-ec2';

A connection to and from a given IP range

Implements:ISecurityGroupRule
Implements:IConnectable
Parameters:cidrIp (string) –
toEgressRuleJSON() → any

Implements @aws-cdk/aws-ec2.ISecurityGroupRule.toEgressRuleJSON()

Produce the egress rule JSON for the given connection

Return type:any
toIngressRuleJSON() → any

Implements @aws-cdk/aws-ec2.ISecurityGroupRule.toIngressRuleJSON()

Produce the ingress rule JSON for the given connection

Return type:any
canInlineRule

Implements @aws-cdk/aws-ec2.ISecurityGroupRule.canInlineRule()

Whether the rule can be inlined into a SecurityGroup or not

Type:boolean (readonly)
cidrIp
Type:string (readonly)
connections

Implements @aws-cdk/aws-ec2.IConnectable.connections()

Type:Connections (readonly)
uniqueId

Implements @aws-cdk/aws-ec2.ISecurityGroupRule.uniqueId()

A unique identifier for this connection peer

Type:string (readonly)

CidrIPv6

class @aws-cdk/aws-ec2.CidrIPv6(cidrIpv6)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.CidrIPv6;
const { CidrIPv6 } = require('@aws-cdk/aws-ec2');
import { CidrIPv6 } from '@aws-cdk/aws-ec2';

A connection to a from a given IPv6 range

Implements:ISecurityGroupRule
Implements:IConnectable
Parameters:cidrIpv6 (string) –
toEgressRuleJSON() → any

Implements @aws-cdk/aws-ec2.ISecurityGroupRule.toEgressRuleJSON()

Produce the egress rule JSON for the given connection

Return type:any
toIngressRuleJSON() → any

Implements @aws-cdk/aws-ec2.ISecurityGroupRule.toIngressRuleJSON()

Produce the ingress rule JSON for the given connection

Return type:any
canInlineRule

Implements @aws-cdk/aws-ec2.ISecurityGroupRule.canInlineRule()

Whether the rule can be inlined into a SecurityGroup or not

Type:boolean (readonly)
cidrIpv6
Type:string (readonly)
connections

Implements @aws-cdk/aws-ec2.IConnectable.connections()

Type:Connections (readonly)
uniqueId

Implements @aws-cdk/aws-ec2.ISecurityGroupRule.uniqueId()

A unique identifier for this connection peer

Type:string (readonly)

ConnectionRule (interface)

class @aws-cdk/aws-ec2.ConnectionRule

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.ConnectionRule;
// ConnectionRule is an interface
import { ConnectionRule } from '@aws-cdk/aws-ec2';
fromPort

Start of port range for the TCP and UDP protocols, or an ICMP type number.

If you specify icmp for the IpProtocol property, you can specify

-1 as a wildcard (i.e., any ICMP type number).

Type:number
description

Description of this connection. It is applied to both the ingress rule

and the egress rule.

Type:string (optional)
Default:No description
protocol

The IP protocol name (tcp, udp, icmp) or number (see Protocol Numbers).

Use -1 to specify all protocols. If you specify -1, or a protocol number

other than tcp, udp, icmp, or 58 (ICMPv6), traffic on all ports is

allowed, regardless of any ports you specify. For tcp, udp, and icmp, you

must specify a port range. For protocol 58 (ICMPv6), you can optionally

specify a port range; if you don’t, traffic for all types and codes is

allowed.

Type:string (optional)
Default:tcp
toPort

End of port range for the TCP and UDP protocols, or an ICMP code.

If you specify icmp for the IpProtocol property, you can specify -1 as a

wildcard (i.e., any ICMP code).

Type:number (optional)
Default:If toPort is not specified, it will be the same as fromPort.

Connections

class @aws-cdk/aws-ec2.Connections([props])

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.Connections;
const { Connections } = require('@aws-cdk/aws-ec2');
import { Connections } from '@aws-cdk/aws-ec2';

Manage the allowed network connections for constructs with Security Groups.

Security Groups can be thought of as a firewall for network-connected

devices. This class makes it easy to allow network connections to and

from security groups, and between security groups individually. When

establishing connectivity between security groups, it will automatically

add rules in both security groups

This object can manage one or more security groups.

Implements:IConnectable
Parameters:props (ConnectionsProps (optional)) –
addSecurityGroup(*securityGroups)

Add a security group to the list of security groups managed by this object

Parameters:*securityGroups (SecurityGroupRef) –
allowDefaultPortFrom(other[, description])

Allow connections from the peer on our default port

Even if the peer has a default port, we will always use our default port.

Parameters:
  • other (IConnectable) –
  • description (string (optional)) –
allowDefaultPortFromAnyIpv4([description])

Allow default connections from all IPv4 ranges

Parameters:description (string (optional)) –
allowDefaultPortInternally([description])

Allow hosts inside the security group to connect to each other

Parameters:description (string (optional)) –
allowDefaultPortTo(other[, description])

Allow connections from the peer on our default port

Even if the peer has a default port, we will always use our default port.

Parameters:
  • other (IConnectable) –
  • description (string (optional)) –
allowFrom(other, portRange[, description])

Allow connections from the peer on the given port

Parameters:
allowFromAnyIPv4(portRange[, description])

Allow from any IPv4 ranges

Parameters:
  • portRange (IPortRange) –
  • description (string (optional)) –
allowInternally(portRange[, description])

Allow hosts inside the security group to connect to each other on the given port

Parameters:
  • portRange (IPortRange) –
  • description (string (optional)) –
allowTo(other, portRange[, description])

Allow connections to the peer on the given port

Parameters:
allowToAnyIPv4(portRange[, description])

Allow to all IPv4 ranges

Parameters:
  • portRange (IPortRange) –
  • description (string (optional)) –
allowToDefaultPort(other[, description])

Allow connections to the security group on their default port

Parameters:
  • other (IConnectable) –
  • description (string (optional)) –
connections

Implements @aws-cdk/aws-ec2.IConnectable.connections()

Type:Connections (readonly)
securityGroups
Type:SecurityGroupRef[] (readonly)
defaultPortRange

The default port configured for this connection peer, if available

Type:IPortRange (optional) (readonly)

ConnectionsProps (interface)

class @aws-cdk/aws-ec2.ConnectionsProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.ConnectionsProps;
// ConnectionsProps is an interface
import { ConnectionsProps } from '@aws-cdk/aws-ec2';

Properties to intialize a new Connections object

defaultPortRange

Default port range for initiating connections to and from this object

Type:IPortRange (optional)
Default:No default port range
securityGroupRule

Class that represents the rule by which others can connect to this connectable

This object is required, but will be derived from securityGroup if that is passed.

Type:ISecurityGroupRule (optional)
Default:Derived from securityGroup if set.
securityGroups

What securityGroup(s) this object is managing connections for

Type:SecurityGroupRef[] (optional)
Default:No security groups

DefaultInstanceTenancy (enum)

class @aws-cdk/aws-ec2.DefaultInstanceTenancy

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.DefaultInstanceTenancy;
const { DefaultInstanceTenancy } = require('@aws-cdk/aws-ec2');
import { DefaultInstanceTenancy } from '@aws-cdk/aws-ec2';

The default tenancy of instances launched into the VPC.

Default

Instances can be launched with any tenancy.

Dedicated

Any instance launched into the VPC automatically has dedicated tenancy, unless you launch it with the default tenancy.

GenericLinuxImage

class @aws-cdk/aws-ec2.GenericLinuxImage(amiMap)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.GenericLinuxImage;
const { GenericLinuxImage } = require('@aws-cdk/aws-ec2');
import { GenericLinuxImage } from '@aws-cdk/aws-ec2';

Construct a Linux machine image from an AMI map

Linux images IDs are not published to SSM parameter store yet, so you’ll have to

manually specify an AMI map.

Implements:IMachineImageSource
Parameters:amiMap (string => string) –
getImage(parent) → @aws-cdk/aws-ec2.MachineImage

Implements @aws-cdk/aws-ec2.IMachineImageSource.getImage()

Return the image to use in the given context

Parameters:parent (@aws-cdk/cdk.Construct) –
Return type:MachineImage
amiMap
Type:string => string (readonly)

IConnectable (interface)

class @aws-cdk/aws-ec2.IConnectable

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.IConnectable;
// IConnectable is an interface
import { IConnectable } from '@aws-cdk/aws-ec2';

The goal of this module is to make possible to write statements like this:

```ts
  • database.connections.allowFrom(fleet);
  • fleet.connections.allowTo(database);
  • rdgw.connections.allowFromCidrIp(‘0.3.1.5/86’);
  • rgdw.connections.allowTrafficTo(fleet, new AllPorts());
  • ```

The insight here is that some connecting peers have information on what ports should

be involved in the connection, and some don’t.

An object that has a Connections object

connections
Type:Connections (readonly)

IMachineImageSource (interface)

class @aws-cdk/aws-ec2.IMachineImageSource

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.IMachineImageSource;
// IMachineImageSource is an interface
import { IMachineImageSource } from '@aws-cdk/aws-ec2';

Interface for classes that can select an appropriate machine image to use

getImage(parent) → @aws-cdk/aws-ec2.MachineImage

Return the image to use in the given context

Parameters:parent (@aws-cdk/cdk.Construct) –
Return type:MachineImage
Abstract:Yes

IPortRange (interface)

class @aws-cdk/aws-ec2.IPortRange

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.IPortRange;
// IPortRange is an interface
import { IPortRange } from '@aws-cdk/aws-ec2';

Interface for classes that provide the connection-specification parts of a security group rule

canInlineRule

Whether the rule containing this port range can be inlined into a securitygroup or not.

Type:boolean (readonly)
toRuleJSON() → any

Produce the ingress/egress rule JSON for the given connection

Return type:any
Abstract:Yes

ISecurityGroupRule (interface)

class @aws-cdk/aws-ec2.ISecurityGroupRule

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.ISecurityGroupRule;
// ISecurityGroupRule is an interface
import { ISecurityGroupRule } from '@aws-cdk/aws-ec2';

Interface for classes that provide the peer-specification parts of a security group rule

canInlineRule

Whether the rule can be inlined into a SecurityGroup or not

Type:boolean (readonly)
uniqueId

A unique identifier for this connection peer

Type:string (readonly)
toEgressRuleJSON() → any

Produce the egress rule JSON for the given connection

Return type:any
Abstract:Yes
toIngressRuleJSON() → any

Produce the ingress rule JSON for the given connection

Return type:any
Abstract:Yes

IcmpAllTypeCodes

class @aws-cdk/aws-ec2.IcmpAllTypeCodes(type)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.IcmpAllTypeCodes;
const { IcmpAllTypeCodes } = require('@aws-cdk/aws-ec2');
import { IcmpAllTypeCodes } from '@aws-cdk/aws-ec2';

All ICMP Codes for a given ICMP Type

Implements:IPortRange
Parameters:type (number) –
toRuleJSON() → any

Implements @aws-cdk/aws-ec2.IPortRange.toRuleJSON()

Produce the ingress/egress rule JSON for the given connection

Return type:any
toString() → string

Returns a string representation of an object.

Return type:string
canInlineRule

Implements @aws-cdk/aws-ec2.IPortRange.canInlineRule()

Whether the rule containing this port range can be inlined into a securitygroup or not.

Type:boolean (readonly)
type
Type:number (readonly)

IcmpAllTypesAndCodes

class @aws-cdk/aws-ec2.IcmpAllTypesAndCodes

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.IcmpAllTypesAndCodes;
const { IcmpAllTypesAndCodes } = require('@aws-cdk/aws-ec2');
import { IcmpAllTypesAndCodes } from '@aws-cdk/aws-ec2';

All ICMP Types & Codes

Implements:IPortRange
toRuleJSON() → any

Implements @aws-cdk/aws-ec2.IPortRange.toRuleJSON()

Produce the ingress/egress rule JSON for the given connection

Return type:any
toString() → string

Returns a string representation of an object.

Return type:string
canInlineRule

Implements @aws-cdk/aws-ec2.IPortRange.canInlineRule()

Whether the rule containing this port range can be inlined into a securitygroup or not.

Type:boolean (readonly)

IcmpPing

class @aws-cdk/aws-ec2.IcmpPing

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.IcmpPing;
const { IcmpPing } = require('@aws-cdk/aws-ec2');
import { IcmpPing } from '@aws-cdk/aws-ec2';

ICMP Ping traffic

Implements:IPortRange
toRuleJSON() → any

Implements @aws-cdk/aws-ec2.IPortRange.toRuleJSON()

Produce the ingress/egress rule JSON for the given connection

Return type:any
toString() → string

Returns a string representation of an object.

Return type:string
canInlineRule

Implements @aws-cdk/aws-ec2.IPortRange.canInlineRule()

Whether the rule containing this port range can be inlined into a securitygroup or not.

Type:boolean (readonly)

IcmpTypeAndCode

class @aws-cdk/aws-ec2.IcmpTypeAndCode(type, code)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.IcmpTypeAndCode;
const { IcmpTypeAndCode } = require('@aws-cdk/aws-ec2');
import { IcmpTypeAndCode } from '@aws-cdk/aws-ec2';

A set of matching ICMP Type & Code

Implements:

IPortRange

Parameters:
  • type (number) –
  • code (number) –
toRuleJSON() → any

Implements @aws-cdk/aws-ec2.IPortRange.toRuleJSON()

Produce the ingress/egress rule JSON for the given connection

Return type:any
toString() → string

Returns a string representation of an object.

Return type:string
canInlineRule

Implements @aws-cdk/aws-ec2.IPortRange.canInlineRule()

Whether the rule containing this port range can be inlined into a securitygroup or not.

Type:boolean (readonly)
code
Type:number (readonly)
type
Type:number (readonly)

InstanceClass (enum)

class @aws-cdk/aws-ec2.InstanceClass

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.InstanceClass;
const { InstanceClass } = require('@aws-cdk/aws-ec2');
import { InstanceClass } from '@aws-cdk/aws-ec2';

What class and generation of instance to use

We have both symbolic and concrete enums for every type.

The first are for people that want to specify by purpose,

the second one are for people who already know exactly what

‘R4’ means.

Standard3

Standard instances, 3rd generation

Standard4

Standard instances, 4th generation

Standard5

Standard instances, 5th generation

Memory3

Memory optimized instances, 3rd generation

Memory4

Memory optimized instances, 3rd generation

Compute3

Compute optimized instances, 3rd generation

Compute4

Compute optimized instances, 4th generation

Compute5

Compute optimized instances, 5th generation

Storage2

Storage-optimized instances, 2nd generation

StorageCompute1

Storage/compute balanced instances, 1st generation

Io3

I/O-optimized instances, 3rd generation

Burstable2

Burstable instances, 2nd generation

Burstable3

Burstable instances, 3rd generation

MemoryIntensive1

Memory-intensive instances, 1st generation

MemoryIntensive1Extended

Memory-intensive instances, extended, 1st generation

Fpga1

Instances with customizable hardware acceleration, 1st generation

Graphics3

Graphics-optimized instances, 3rd generation

Parallel2

Parallel-processing optimized instances, 2nd generation

Parallel3

Parallel-processing optimized instances, 3nd generation

InstanceSize (enum)

class @aws-cdk/aws-ec2.InstanceSize

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.InstanceSize;
const { InstanceSize } = require('@aws-cdk/aws-ec2');
import { InstanceSize } from '@aws-cdk/aws-ec2';

What size of instance to use

None
Micro
Small
Medium
Large
XLarge
XLarge2
XLarge4
XLarge8
XLarge9
XLarge10
XLarge12
XLarge16
XLarge18
XLarge24
XLarge32

InstanceType

class @aws-cdk/aws-ec2.InstanceType(instanceTypeIdentifier)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.InstanceType;
const { InstanceType } = require('@aws-cdk/aws-ec2');
import { InstanceType } from '@aws-cdk/aws-ec2';

Instance type for EC2 instances

This class takes a literal string, good if you already

know the identifier of the type you want.

Parameters:instanceTypeIdentifier (string) –
toString() → string

Return the instance type as a dotted string

Return type:string
instanceTypeIdentifier
Type:string (readonly)

InstanceTypePair

class @aws-cdk/aws-ec2.InstanceTypePair(instanceClass, instanceSize)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.InstanceTypePair;
const { InstanceTypePair } = require('@aws-cdk/aws-ec2');
import { InstanceTypePair } from '@aws-cdk/aws-ec2';

Instance type for EC2 instances

This class takes a combination of a class and size.

Be aware that not all combinations of class and size are available, and not all

classes are available in all regions.

Extends:

InstanceType

Parameters:
instanceClass
Type:InstanceClass (readonly)
instanceSize
Type:InstanceSize (readonly)
toString() → string

Inherited from @aws-cdk/aws-ec2.InstanceType

Return the instance type as a dotted string

Return type:string
instanceTypeIdentifier

Inherited from @aws-cdk/aws-ec2.InstanceType

Type:string (readonly)

LinuxOS

class @aws-cdk/aws-ec2.LinuxOS

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.LinuxOS;
const { LinuxOS } = require('@aws-cdk/aws-ec2');
import { LinuxOS } from '@aws-cdk/aws-ec2';

OS features specialized for Linux

Extends:OperatingSystem
createUserData(scripts) → string

Implements @aws-cdk/aws-ec2.OperatingSystem.createUserData()

Parameters:scripts (string[]) –
Return type:string
type

Implements @aws-cdk/aws-ec2.OperatingSystem.type()

Type:OperatingSystemType (readonly)

MachineImage

class @aws-cdk/aws-ec2.MachineImage(imageId, os)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.MachineImage;
const { MachineImage } = require('@aws-cdk/aws-ec2');
import { MachineImage } from '@aws-cdk/aws-ec2';

Representation of a machine to be launched

Combines an AMI ID with an OS.

Parameters:
imageId
Type:string (readonly)
os
Type:OperatingSystem (readonly)

NetworkInterfaceSecondaryPrivateIpAddresses

class @aws-cdk/aws-ec2.NetworkInterfaceSecondaryPrivateIpAddresses([valueOrFunction[, displayName]])

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.NetworkInterfaceSecondaryPrivateIpAddresses;
const { NetworkInterfaceSecondaryPrivateIpAddresses } = require('@aws-cdk/aws-ec2');
import { NetworkInterfaceSecondaryPrivateIpAddresses } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Token

Parameters:
  • valueOrFunction (any (optional)) – What this token will evaluate to, literal or function.
  • displayName (string (optional)) – A human-readable display hint for this Token
concat(left, right) → @aws-cdk/cdk.Token

Inherited from @aws-cdk/cdk.Token

Return a concated version of this Token in a string context

The default implementation of this combines strings, but specialized

implements of Token can return a more appropriate value.

Parameters:
  • left (any) –
  • right (any) –
Return type:

@aws-cdk/cdk.Token

resolve() → any

Inherited from @aws-cdk/cdk.Token

Returns:The resolved value for this token.
Return type:any
toJSON() → any

Inherited from @aws-cdk/cdk.Token

Turn this Token into JSON

This gets called by JSON.stringify(). We want to prohibit this, because

it’s not possible to do this properly, so we just throw an error here.

Return type:any
toList() → string[]

Inherited from @aws-cdk/cdk.Token

Return a string list representation of this token

Call this if the Token intrinsically evaluates to a list of strings.

If so, you can represent the Token in a similar way in the type

system.

Note that even though the Token is represented as a list of strings, you

still cannot do any operations on it such as concatenation, indexing,

or taking its length. The only useful operations you can do to these lists

is constructing a FnJoin or a FnSelect on it.

Return type:string[]
toString() → string

Inherited from @aws-cdk/cdk.Token

Return a reversible string representation of this token

If the Token is initialized with a literal, the stringified value of the

literal is returned. Otherwise, a special quoted string representation

of the Token is returned that can be embedded into other strings.

Strings with quoted Tokens in them can be restored back into

complex values with the Tokens restored by calling resolve()

on the string.

Return type:string
displayName

Inherited from @aws-cdk/cdk.Token

A human-readable display hint for this Token

Type:string (optional) (readonly)
valueOrFunction

Inherited from @aws-cdk/cdk.Token

What this token will evaluate to, literal or function.

Type:any (optional) (readonly)

OperatingSystem

class @aws-cdk/aws-ec2.OperatingSystem

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.OperatingSystem;
const { OperatingSystem } = require('@aws-cdk/aws-ec2');
import { OperatingSystem } from '@aws-cdk/aws-ec2';

Abstraction of OS features we need to be aware of

Abstract:Yes
createUserData(scripts) → string
Parameters:scripts (string[]) –
Return type:string
Abstract:Yes
type
Type:OperatingSystemType (readonly) (abstract)

OperatingSystemType (enum)

class @aws-cdk/aws-ec2.OperatingSystemType

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.OperatingSystemType;
const { OperatingSystemType } = require('@aws-cdk/aws-ec2');
import { OperatingSystemType } from '@aws-cdk/aws-ec2';

The OS type of a particular image

Linux
Windows

PrefixList

class @aws-cdk/aws-ec2.PrefixList(prefixListId)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.PrefixList;
const { PrefixList } = require('@aws-cdk/aws-ec2');
import { PrefixList } from '@aws-cdk/aws-ec2';

A prefix list

Prefix lists are used to allow traffic to VPC-local service endpoints.

For more information, see this page:

https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/vpc-endpoints.html

Implements:ISecurityGroupRule
Implements:IConnectable
Parameters:prefixListId (string) –
toEgressRuleJSON() → any

Implements @aws-cdk/aws-ec2.ISecurityGroupRule.toEgressRuleJSON()

Produce the egress rule JSON for the given connection

Return type:any
toIngressRuleJSON() → any

Implements @aws-cdk/aws-ec2.ISecurityGroupRule.toIngressRuleJSON()

Produce the ingress rule JSON for the given connection

Return type:any
canInlineRule

Implements @aws-cdk/aws-ec2.ISecurityGroupRule.canInlineRule()

Whether the rule can be inlined into a SecurityGroup or not

Type:boolean (readonly)
connections

Implements @aws-cdk/aws-ec2.IConnectable.connections()

Type:Connections (readonly)
prefixListId
Type:string (readonly)
uniqueId

Implements @aws-cdk/aws-ec2.ISecurityGroupRule.uniqueId()

A unique identifier for this connection peer

Type:string (readonly)

Protocol (enum)

class @aws-cdk/aws-ec2.Protocol

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.Protocol;
const { Protocol } = require('@aws-cdk/aws-ec2');
import { Protocol } from '@aws-cdk/aws-ec2';

Protocol for use in Connection Rules

All
Tcp
Udp
Icmp
Icmpv6

SecurityGroup

class @aws-cdk/aws-ec2.SecurityGroup(parent, name, props)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.SecurityGroup;
const { SecurityGroup } = require('@aws-cdk/aws-ec2');
import { SecurityGroup } from '@aws-cdk/aws-ec2';

Creates an Amazon EC2 security group within a VPC.

This class has an additional optimization over SecurityGroupRef that it can also create

inline ingress and egress rule (which saves on the total number of resources inside

the template).

Extends:

SecurityGroupRef

Implements:

@aws-cdk/cdk.ITaggable

Parameters:
addEgressRule(peer, connection[, description])

Overrides @aws-cdk/aws-ec2.SecurityGroupRef.addEgressRule()

Parameters:
addIngressRule(peer, connection[, description])

Overrides @aws-cdk/aws-ec2.SecurityGroupRef.addIngressRule()

Parameters:
groupName

An attribute that represents the security group name.

Type:string (readonly)
securityGroupId

Implements @aws-cdk/aws-ec2.SecurityGroupRef.securityGroupId()

The ID of the security group

Type:string (readonly)
tags

Implements @aws-cdk/cdk.ITaggable.tags()

Manage tags for this construct and children

Type:@aws-cdk/cdk.TagManager (readonly)
vpcId

An attribute that represents the physical VPC ID this security group is part of.

Type:string (readonly)
export() → @aws-cdk/aws-ec2.SecurityGroupRefProps

Inherited from @aws-cdk/aws-ec2.SecurityGroupRef

Export this SecurityGroup for use in a different Stack

Return type:SecurityGroupRefProps
toEgressRuleJSON() → any

Inherited from @aws-cdk/aws-ec2.SecurityGroupRef

Produce the egress rule JSON for the given connection

Return type:any
toIngressRuleJSON() → any

Inherited from @aws-cdk/aws-ec2.SecurityGroupRef

Produce the ingress rule JSON for the given connection

Return type:any
canInlineRule

Inherited from @aws-cdk/aws-ec2.SecurityGroupRef

Whether the rule can be inlined into a SecurityGroup or not

Type:boolean (readonly)
connections

Inherited from @aws-cdk/aws-ec2.SecurityGroupRef

Type:Connections (readonly)
defaultPortRange

Inherited from @aws-cdk/aws-ec2.SecurityGroupRef

FIXME: Where to place this??

Type:IPortRange (optional) (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)

SecurityGroupProps (interface)

class @aws-cdk/aws-ec2.SecurityGroupProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.SecurityGroupProps;
// SecurityGroupProps is an interface
import { SecurityGroupProps } from '@aws-cdk/aws-ec2';
vpc

The VPC in which to create the security group.

Type:VpcNetworkRef
allowAllOutbound

Whether to allow all outbound traffic by default.

If this is set to true, there will only be a single egress rule which allows all

outbound traffic. If this is set to false, no outbound traffic will be allowed by

default and all egress traffic must be explicitly authorized.

Type:boolean (optional)
Default:true
description

A description of the security group.

Type:string (optional)
Default:The default name will be the construct’s CDK path.
groupName

The name of the security group. For valid values, see the GroupName

parameter of the CreateSecurityGroup action in the Amazon EC2 API

Reference.

It is not recommended to use an explicit group name.

Type:string (optional)
Default:If you don’t specify a GroupName, AWS CloudFormation generates a

unique physical ID and uses that ID for the group name.

@aws-cdk/aws-ec2.tags

The AWS resource tags to associate with the security group.

Type:string => string (optional)

SecurityGroupRef

class @aws-cdk/aws-ec2.SecurityGroupRef(parent, id)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.SecurityGroupRef;
const { SecurityGroupRef } = require('@aws-cdk/aws-ec2');
import { SecurityGroupRef } from '@aws-cdk/aws-ec2';

A SecurityGroup that is not created in this template

Extends:

@aws-cdk/cdk.Construct

Implements:

ISecurityGroupRule

Implements:

IConnectable

Abstract:

Yes

Parameters:
static import(parent, id, props) → @aws-cdk/aws-ec2.SecurityGroupRef

Import an existing SecurityGroup

Parameters:
Return type:

SecurityGroupRef

addEgressRule(peer, connection[, description])
Parameters:
addIngressRule(peer, connection[, description])
Parameters:
export() → @aws-cdk/aws-ec2.SecurityGroupRefProps

Export this SecurityGroup for use in a different Stack

Return type:SecurityGroupRefProps
toEgressRuleJSON() → any

Implements @aws-cdk/aws-ec2.ISecurityGroupRule.toEgressRuleJSON()

Produce the egress rule JSON for the given connection

Return type:any
toIngressRuleJSON() → any

Implements @aws-cdk/aws-ec2.ISecurityGroupRule.toIngressRuleJSON()

Produce the ingress rule JSON for the given connection

Return type:any
canInlineRule

Implements @aws-cdk/aws-ec2.ISecurityGroupRule.canInlineRule()

Whether the rule can be inlined into a SecurityGroup or not

Type:boolean (readonly)
connections

Implements @aws-cdk/aws-ec2.IConnectable.connections()

Type:Connections (readonly)
securityGroupId
Type:string (readonly) (abstract)
defaultPortRange

FIXME: Where to place this??

Type:IPortRange (optional) (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)

SecurityGroupRefProps (interface)

class @aws-cdk/aws-ec2.SecurityGroupRefProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.SecurityGroupRefProps;
// SecurityGroupRefProps is an interface
import { SecurityGroupRefProps } from '@aws-cdk/aws-ec2';
securityGroupId

ID of security group

Type:string

SubnetConfiguration (interface)

class @aws-cdk/aws-ec2.SubnetConfiguration

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.SubnetConfiguration;
// SubnetConfiguration is an interface
import { SubnetConfiguration } from '@aws-cdk/aws-ec2';

Specify configuration parameters for a VPC to be built

name

The common Logical Name for the VpcSubnet

Thi name will be suffixed with an integer correlating to a specific

availability zone.

Type:string
subnetType

The type of Subnet to configure.

The Subnet type will control the ability to route and connect to the

Internet.

Type:SubnetType
cidrMask

The CIDR Mask or the number of leading 1 bits in the routing mask

Valid values are 16 - 28

Type:number (optional)
tags

The AWS resource tags to associate with the resource.

Type:string => string (optional)

SubnetIpv6CidrBlocks

class @aws-cdk/aws-ec2.SubnetIpv6CidrBlocks([valueOrFunction[, displayName]])

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.SubnetIpv6CidrBlocks;
const { SubnetIpv6CidrBlocks } = require('@aws-cdk/aws-ec2');
import { SubnetIpv6CidrBlocks } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Token

Parameters:
  • valueOrFunction (any (optional)) – What this token will evaluate to, literal or function.
  • displayName (string (optional)) – A human-readable display hint for this Token
concat(left, right) → @aws-cdk/cdk.Token

Inherited from @aws-cdk/cdk.Token

Return a concated version of this Token in a string context

The default implementation of this combines strings, but specialized

implements of Token can return a more appropriate value.

Parameters:
  • left (any) –
  • right (any) –
Return type:

@aws-cdk/cdk.Token

resolve() → any

Inherited from @aws-cdk/cdk.Token

Returns:The resolved value for this token.
Return type:any
toJSON() → any

Inherited from @aws-cdk/cdk.Token

Turn this Token into JSON

This gets called by JSON.stringify(). We want to prohibit this, because

it’s not possible to do this properly, so we just throw an error here.

Return type:any
toList() → string[]

Inherited from @aws-cdk/cdk.Token

Return a string list representation of this token

Call this if the Token intrinsically evaluates to a list of strings.

If so, you can represent the Token in a similar way in the type

system.

Note that even though the Token is represented as a list of strings, you

still cannot do any operations on it such as concatenation, indexing,

or taking its length. The only useful operations you can do to these lists

is constructing a FnJoin or a FnSelect on it.

Return type:string[]
toString() → string

Inherited from @aws-cdk/cdk.Token

Return a reversible string representation of this token

If the Token is initialized with a literal, the stringified value of the

literal is returned. Otherwise, a special quoted string representation

of the Token is returned that can be embedded into other strings.

Strings with quoted Tokens in them can be restored back into

complex values with the Tokens restored by calling resolve()

on the string.

Return type:string
displayName

Inherited from @aws-cdk/cdk.Token

A human-readable display hint for this Token

Type:string (optional) (readonly)
valueOrFunction

Inherited from @aws-cdk/cdk.Token

What this token will evaluate to, literal or function.

Type:any (optional) (readonly)

SubnetType (enum)

class @aws-cdk/aws-ec2.SubnetType

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.SubnetType;
const { SubnetType } = require('@aws-cdk/aws-ec2');
import { SubnetType } from '@aws-cdk/aws-ec2';

The type of Subnet

Isolated

Isolated Subnets do not route Outbound traffic

This can be good for subnets with RDS or

Elasticache endpoints

Private

Subnet that routes to the internet, but not vice versa.

Instances in a private subnet can connect to the Internet, but will not

allow connections to be initiated from the Internet.

Outbound traffic will be routed via a NAT Gateway. Preference being in

the same AZ, but if not available will use another AZ (control by

specifing maxGateways on VpcNetwork). This might be used for

experimental cost conscious accounts or accounts where HA outbound

traffic is not needed.

Public

Subnet connected to the Internet

Instances in a Public subnet can connect to the Internet and can be

connected to from the Internet as long as they are launched with public

IPs (controlled on the AutoScalingGroup or other constructs that launch

instances).

Public subnets route outbound traffic via an Internet Gateway.

TcpAllPorts

class @aws-cdk/aws-ec2.TcpAllPorts

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.TcpAllPorts;
const { TcpAllPorts } = require('@aws-cdk/aws-ec2');
import { TcpAllPorts } from '@aws-cdk/aws-ec2';

All TCP Ports

Implements:IPortRange
toRuleJSON() → any

Implements @aws-cdk/aws-ec2.IPortRange.toRuleJSON()

Produce the ingress/egress rule JSON for the given connection

Return type:any
toString() → string

Returns a string representation of an object.

Return type:string
canInlineRule

Implements @aws-cdk/aws-ec2.IPortRange.canInlineRule()

Whether the rule containing this port range can be inlined into a securitygroup or not.

Type:boolean (readonly)

TcpPort

class @aws-cdk/aws-ec2.TcpPort(port)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.TcpPort;
const { TcpPort } = require('@aws-cdk/aws-ec2');
import { TcpPort } from '@aws-cdk/aws-ec2';

A single TCP port

Implements:IPortRange
Parameters:port (number) –
toRuleJSON() → any

Implements @aws-cdk/aws-ec2.IPortRange.toRuleJSON()

Produce the ingress/egress rule JSON for the given connection

Return type:any
toString() → string

Returns a string representation of an object.

Return type:string
canInlineRule

Implements @aws-cdk/aws-ec2.IPortRange.canInlineRule()

Whether the rule containing this port range can be inlined into a securitygroup or not.

Type:boolean (readonly)
port
Type:number (readonly)

TcpPortFromAttribute

class @aws-cdk/aws-ec2.TcpPortFromAttribute(port)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.TcpPortFromAttribute;
const { TcpPortFromAttribute } = require('@aws-cdk/aws-ec2');
import { TcpPortFromAttribute } from '@aws-cdk/aws-ec2';

A single TCP port that is provided by a resource attribute

Implements:IPortRange
Parameters:port (string) –
toRuleJSON() → any

Implements @aws-cdk/aws-ec2.IPortRange.toRuleJSON()

Produce the ingress/egress rule JSON for the given connection

Return type:any
toString() → string

Returns a string representation of an object.

Return type:string
canInlineRule

Implements @aws-cdk/aws-ec2.IPortRange.canInlineRule()

Whether the rule containing this port range can be inlined into a securitygroup or not.

Type:boolean (readonly)
port
Type:string (readonly)

TcpPortRange

class @aws-cdk/aws-ec2.TcpPortRange(startPort, endPort)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.TcpPortRange;
const { TcpPortRange } = require('@aws-cdk/aws-ec2');
import { TcpPortRange } from '@aws-cdk/aws-ec2';

A TCP port range

Implements:

IPortRange

Parameters:
  • startPort (number) –
  • endPort (number) –
toRuleJSON() → any

Implements @aws-cdk/aws-ec2.IPortRange.toRuleJSON()

Produce the ingress/egress rule JSON for the given connection

Return type:any
toString() → string

Returns a string representation of an object.

Return type:string
canInlineRule

Implements @aws-cdk/aws-ec2.IPortRange.canInlineRule()

Whether the rule containing this port range can be inlined into a securitygroup or not.

Type:boolean (readonly)
endPort
Type:number (readonly)
startPort
Type:number (readonly)

UdpAllPorts

class @aws-cdk/aws-ec2.UdpAllPorts

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.UdpAllPorts;
const { UdpAllPorts } = require('@aws-cdk/aws-ec2');
import { UdpAllPorts } from '@aws-cdk/aws-ec2';

All UDP Ports

Implements:IPortRange
toRuleJSON() → any

Implements @aws-cdk/aws-ec2.IPortRange.toRuleJSON()

Produce the ingress/egress rule JSON for the given connection

Return type:any
toString() → string

Returns a string representation of an object.

Return type:string
canInlineRule

Implements @aws-cdk/aws-ec2.IPortRange.canInlineRule()

Whether the rule containing this port range can be inlined into a securitygroup or not.

Type:boolean (readonly)

UdpPort

class @aws-cdk/aws-ec2.UdpPort(port)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.UdpPort;
const { UdpPort } = require('@aws-cdk/aws-ec2');
import { UdpPort } from '@aws-cdk/aws-ec2';

A single UDP port

Implements:IPortRange
Parameters:port (number) –
toRuleJSON() → any

Implements @aws-cdk/aws-ec2.IPortRange.toRuleJSON()

Produce the ingress/egress rule JSON for the given connection

Return type:any
toString() → string

Returns a string representation of an object.

Return type:string
canInlineRule

Implements @aws-cdk/aws-ec2.IPortRange.canInlineRule()

Whether the rule containing this port range can be inlined into a securitygroup or not.

Type:boolean (readonly)
port
Type:number (readonly)

UdpPortFromAttribute

class @aws-cdk/aws-ec2.UdpPortFromAttribute(port)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.UdpPortFromAttribute;
const { UdpPortFromAttribute } = require('@aws-cdk/aws-ec2');
import { UdpPortFromAttribute } from '@aws-cdk/aws-ec2';

A single UDP port that is provided by a resource attribute

Implements:IPortRange
Parameters:port (string) –
toRuleJSON() → any

Implements @aws-cdk/aws-ec2.IPortRange.toRuleJSON()

Produce the ingress/egress rule JSON for the given connection

Return type:any
toString() → string

Returns a string representation of an object.

Return type:string
canInlineRule

Implements @aws-cdk/aws-ec2.IPortRange.canInlineRule()

Whether the rule containing this port range can be inlined into a securitygroup or not.

Type:boolean (readonly)
port
Type:string (readonly)

UdpPortRange

class @aws-cdk/aws-ec2.UdpPortRange(startPort, endPort)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.UdpPortRange;
const { UdpPortRange } = require('@aws-cdk/aws-ec2');
import { UdpPortRange } from '@aws-cdk/aws-ec2';

A UDP port range

Implements:

IPortRange

Parameters:
  • startPort (number) –
  • endPort (number) –
toRuleJSON() → any

Implements @aws-cdk/aws-ec2.IPortRange.toRuleJSON()

Produce the ingress/egress rule JSON for the given connection

Return type:any
toString() → string

Returns a string representation of an object.

Return type:string
canInlineRule

Implements @aws-cdk/aws-ec2.IPortRange.canInlineRule()

Whether the rule containing this port range can be inlined into a securitygroup or not.

Type:boolean (readonly)
endPort
Type:number (readonly)
startPort
Type:number (readonly)

VPCCidrBlockAssociations

class @aws-cdk/aws-ec2.VPCCidrBlockAssociations([valueOrFunction[, displayName]])

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.VPCCidrBlockAssociations;
const { VPCCidrBlockAssociations } = require('@aws-cdk/aws-ec2');
import { VPCCidrBlockAssociations } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Token

Parameters:
  • valueOrFunction (any (optional)) – What this token will evaluate to, literal or function.
  • displayName (string (optional)) – A human-readable display hint for this Token
concat(left, right) → @aws-cdk/cdk.Token

Inherited from @aws-cdk/cdk.Token

Return a concated version of this Token in a string context

The default implementation of this combines strings, but specialized

implements of Token can return a more appropriate value.

Parameters:
  • left (any) –
  • right (any) –
Return type:

@aws-cdk/cdk.Token

resolve() → any

Inherited from @aws-cdk/cdk.Token

Returns:The resolved value for this token.
Return type:any
toJSON() → any

Inherited from @aws-cdk/cdk.Token

Turn this Token into JSON

This gets called by JSON.stringify(). We want to prohibit this, because

it’s not possible to do this properly, so we just throw an error here.

Return type:any
toList() → string[]

Inherited from @aws-cdk/cdk.Token

Return a string list representation of this token

Call this if the Token intrinsically evaluates to a list of strings.

If so, you can represent the Token in a similar way in the type

system.

Note that even though the Token is represented as a list of strings, you

still cannot do any operations on it such as concatenation, indexing,

or taking its length. The only useful operations you can do to these lists

is constructing a FnJoin or a FnSelect on it.

Return type:string[]
toString() → string

Inherited from @aws-cdk/cdk.Token

Return a reversible string representation of this token

If the Token is initialized with a literal, the stringified value of the

literal is returned. Otherwise, a special quoted string representation

of the Token is returned that can be embedded into other strings.

Strings with quoted Tokens in them can be restored back into

complex values with the Tokens restored by calling resolve()

on the string.

Return type:string
displayName

Inherited from @aws-cdk/cdk.Token

A human-readable display hint for this Token

Type:string (optional) (readonly)
valueOrFunction

Inherited from @aws-cdk/cdk.Token

What this token will evaluate to, literal or function.

Type:any (optional) (readonly)

VPCEndpointDnsEntries

class @aws-cdk/aws-ec2.VPCEndpointDnsEntries([valueOrFunction[, displayName]])

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.VPCEndpointDnsEntries;
const { VPCEndpointDnsEntries } = require('@aws-cdk/aws-ec2');
import { VPCEndpointDnsEntries } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Token

Parameters:
  • valueOrFunction (any (optional)) – What this token will evaluate to, literal or function.
  • displayName (string (optional)) – A human-readable display hint for this Token
concat(left, right) → @aws-cdk/cdk.Token

Inherited from @aws-cdk/cdk.Token

Return a concated version of this Token in a string context

The default implementation of this combines strings, but specialized

implements of Token can return a more appropriate value.

Parameters:
  • left (any) –
  • right (any) –
Return type:

@aws-cdk/cdk.Token

resolve() → any

Inherited from @aws-cdk/cdk.Token

Returns:The resolved value for this token.
Return type:any
toJSON() → any

Inherited from @aws-cdk/cdk.Token

Turn this Token into JSON

This gets called by JSON.stringify(). We want to prohibit this, because

it’s not possible to do this properly, so we just throw an error here.

Return type:any
toList() → string[]

Inherited from @aws-cdk/cdk.Token

Return a string list representation of this token

Call this if the Token intrinsically evaluates to a list of strings.

If so, you can represent the Token in a similar way in the type

system.

Note that even though the Token is represented as a list of strings, you

still cannot do any operations on it such as concatenation, indexing,

or taking its length. The only useful operations you can do to these lists

is constructing a FnJoin or a FnSelect on it.

Return type:string[]
toString() → string

Inherited from @aws-cdk/cdk.Token

Return a reversible string representation of this token

If the Token is initialized with a literal, the stringified value of the

literal is returned. Otherwise, a special quoted string representation

of the Token is returned that can be embedded into other strings.

Strings with quoted Tokens in them can be restored back into

complex values with the Tokens restored by calling resolve()

on the string.

Return type:string
displayName

Inherited from @aws-cdk/cdk.Token

A human-readable display hint for this Token

Type:string (optional) (readonly)
valueOrFunction

Inherited from @aws-cdk/cdk.Token

What this token will evaluate to, literal or function.

Type:any (optional) (readonly)

VPCEndpointNetworkInterfaceIds

class @aws-cdk/aws-ec2.VPCEndpointNetworkInterfaceIds([valueOrFunction[, displayName]])

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.VPCEndpointNetworkInterfaceIds;
const { VPCEndpointNetworkInterfaceIds } = require('@aws-cdk/aws-ec2');
import { VPCEndpointNetworkInterfaceIds } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Token

Parameters:
  • valueOrFunction (any (optional)) – What this token will evaluate to, literal or function.
  • displayName (string (optional)) – A human-readable display hint for this Token
concat(left, right) → @aws-cdk/cdk.Token

Inherited from @aws-cdk/cdk.Token

Return a concated version of this Token in a string context

The default implementation of this combines strings, but specialized

implements of Token can return a more appropriate value.

Parameters:
  • left (any) –
  • right (any) –
Return type:

@aws-cdk/cdk.Token

resolve() → any

Inherited from @aws-cdk/cdk.Token

Returns:The resolved value for this token.
Return type:any
toJSON() → any

Inherited from @aws-cdk/cdk.Token

Turn this Token into JSON

This gets called by JSON.stringify(). We want to prohibit this, because

it’s not possible to do this properly, so we just throw an error here.

Return type:any
toList() → string[]

Inherited from @aws-cdk/cdk.Token

Return a string list representation of this token

Call this if the Token intrinsically evaluates to a list of strings.

If so, you can represent the Token in a similar way in the type

system.

Note that even though the Token is represented as a list of strings, you

still cannot do any operations on it such as concatenation, indexing,

or taking its length. The only useful operations you can do to these lists

is constructing a FnJoin or a FnSelect on it.

Return type:string[]
toString() → string

Inherited from @aws-cdk/cdk.Token

Return a reversible string representation of this token

If the Token is initialized with a literal, the stringified value of the

literal is returned. Otherwise, a special quoted string representation

of the Token is returned that can be embedded into other strings.

Strings with quoted Tokens in them can be restored back into

complex values with the Tokens restored by calling resolve()

on the string.

Return type:string
displayName

Inherited from @aws-cdk/cdk.Token

A human-readable display hint for this Token

Type:string (optional) (readonly)
valueOrFunction

Inherited from @aws-cdk/cdk.Token

What this token will evaluate to, literal or function.

Type:any (optional) (readonly)

VPCIpv6CidrBlocks

class @aws-cdk/aws-ec2.VPCIpv6CidrBlocks([valueOrFunction[, displayName]])

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.VPCIpv6CidrBlocks;
const { VPCIpv6CidrBlocks } = require('@aws-cdk/aws-ec2');
import { VPCIpv6CidrBlocks } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Token

Parameters:
  • valueOrFunction (any (optional)) – What this token will evaluate to, literal or function.
  • displayName (string (optional)) – A human-readable display hint for this Token
concat(left, right) → @aws-cdk/cdk.Token

Inherited from @aws-cdk/cdk.Token

Return a concated version of this Token in a string context

The default implementation of this combines strings, but specialized

implements of Token can return a more appropriate value.

Parameters:
  • left (any) –
  • right (any) –
Return type:

@aws-cdk/cdk.Token

resolve() → any

Inherited from @aws-cdk/cdk.Token

Returns:The resolved value for this token.
Return type:any
toJSON() → any

Inherited from @aws-cdk/cdk.Token

Turn this Token into JSON

This gets called by JSON.stringify(). We want to prohibit this, because

it’s not possible to do this properly, so we just throw an error here.

Return type:any
toList() → string[]

Inherited from @aws-cdk/cdk.Token

Return a string list representation of this token

Call this if the Token intrinsically evaluates to a list of strings.

If so, you can represent the Token in a similar way in the type

system.

Note that even though the Token is represented as a list of strings, you

still cannot do any operations on it such as concatenation, indexing,

or taking its length. The only useful operations you can do to these lists

is constructing a FnJoin or a FnSelect on it.

Return type:string[]
toString() → string

Inherited from @aws-cdk/cdk.Token

Return a reversible string representation of this token

If the Token is initialized with a literal, the stringified value of the

literal is returned. Otherwise, a special quoted string representation

of the Token is returned that can be embedded into other strings.

Strings with quoted Tokens in them can be restored back into

complex values with the Tokens restored by calling resolve()

on the string.

Return type:string
displayName

Inherited from @aws-cdk/cdk.Token

A human-readable display hint for this Token

Type:string (optional) (readonly)
valueOrFunction

Inherited from @aws-cdk/cdk.Token

What this token will evaluate to, literal or function.

Type:any (optional) (readonly)

VpcNetwork

class @aws-cdk/aws-ec2.VpcNetwork(parent, name[, props])

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.VpcNetwork;
const { VpcNetwork } = require('@aws-cdk/aws-ec2');
import { VpcNetwork } from '@aws-cdk/aws-ec2';

VpcNetwork deploys an AWS VPC, with public and private subnets per Availability Zone.

For example:

import { VpcNetwork } from @aws-cdk/aws-ec2

const vpc = new VpcNetwork(this, {

cidr: “10.0.0.0/16”

})

// Iterate the public subnets

for (let subnet of vpc.publicSubnets) {

}

// Iterate the private subnets

for (let subnet of vpc.privateSubnets) {

}

Extends:

VpcNetworkRef

Implements:

@aws-cdk/cdk.ITaggable

Parameters:
DEFAULT_CIDR_RANGE

The default CIDR range used when creating VPCs.

This can be overridden using VpcNetworkProps when creating a VPCNetwork resource.

e.g. new VpcResource(this, { cidr: ‘192.168.0.0./16’ })

Type:string (readonly) (static)
DEFAULT_SUBNETS

The default subnet configuration

1 Public and 1 Private subnet per AZ evenly split

Type:SubnetConfiguration[] (readonly) (static)
availabilityZones

Implements @aws-cdk/aws-ec2.VpcNetworkRef.availabilityZones()

AZs for this VPC

Type:string[] (readonly)
cidr
Type:string (readonly)
isolatedSubnets

Implements @aws-cdk/aws-ec2.VpcNetworkRef.isolatedSubnets()

List of isolated subnets in this VPC

Type:VpcSubnetRef[] (readonly)
privateSubnets

Implements @aws-cdk/aws-ec2.VpcNetworkRef.privateSubnets()

List of private subnets in this VPC

Type:VpcSubnetRef[] (readonly)
publicSubnets

Implements @aws-cdk/aws-ec2.VpcNetworkRef.publicSubnets()

List of public subnets in this VPC

Type:VpcSubnetRef[] (readonly)
tags

Implements @aws-cdk/cdk.ITaggable.tags()

Manage tags for this construct and children

Type:@aws-cdk/cdk.TagManager (readonly)
vpcId

Implements @aws-cdk/aws-ec2.VpcNetworkRef.vpcId()

Identifier for this VPC

Type:string (readonly)
export() → @aws-cdk/aws-ec2.VpcNetworkRefProps

Inherited from @aws-cdk/aws-ec2.VpcNetworkRef

Export this VPC from the stack

Return type:VpcNetworkRefProps
internetDependency() → @aws-cdk/cdk.IDependable

Inherited from @aws-cdk/aws-ec2.VpcNetworkRef

Take a dependency on internet connectivity having been added to this VPC

Take a dependency on this if your constructs need an Internet Gateway

added to the VPC before they can be constructed.

This method is for construct authors; application builders should not

need to call this.

Return type:@aws-cdk/cdk.IDependable
isPublicSubnet(subnet) → boolean

Inherited from @aws-cdk/aws-ec2.VpcNetworkRef

Return whether the given subnet is one of this VPC’s public subnets.

The subnet must literally be one of the subnet object obtained from

this VPC. A subnet that merely represents the same subnet will

never return true.

Parameters:subnet (VpcSubnetRef) –
Return type:boolean
subnets([placement]) → @aws-cdk/aws-ec2.VpcSubnetRef[]

Inherited from @aws-cdk/aws-ec2.VpcNetworkRef

Return the subnets appropriate for the placement strategy

Parameters:placement (VpcPlacementStrategy (optional)) –
Return type:VpcSubnetRef[]
dependencyElements

Inherited from @aws-cdk/aws-ec2.VpcNetworkRef

Parts of the VPC that constitute full construction

Type:@aws-cdk/cdk.IDependable[] (readonly)
internetDependencies

Inherited from @aws-cdk/aws-ec2.VpcNetworkRef

Dependencies for internet connectivity

Protected property

Type:@aws-cdk/cdk.IDependable[] (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)

VpcNetworkProps (interface)

class @aws-cdk/aws-ec2.VpcNetworkProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.VpcNetworkProps;
// VpcNetworkProps is an interface
import { VpcNetworkProps } from '@aws-cdk/aws-ec2';

VpcNetworkProps allows you to specify configuration options for a VPC

cidr

The CIDR range to use for the VPC (e.g. ‘10.0.0.0/16’). Should be a minimum of /28 and maximum size of /16.

The range will be split evenly into two subnets per Availability Zone (one public, one private).

Type:string (optional)
defaultInstanceTenancy

The default tenancy of instances launched into the VPC.

By default, instances will be launched with default (shared) tenancy.

By setting this to dedicated tenancy, instances will be launched on hardware dedicated

to a single AWS customer, unless specifically specified at instance launch time.

Please note, not all instance types are usable with Dedicated tenancy.

Type:DefaultInstanceTenancy (optional)
enableDnsHostnames

Indicates whether the instances launched in the VPC get public DNS hostnames.

If this attribute is true, instances in the VPC get public DNS hostnames,

but only if the enableDnsSupport attribute is also set to true.

Type:boolean (optional)
enableDnsSupport

Indicates whether the DNS resolution is supported for the VPC. If this attribute

is false, the Amazon-provided DNS server in the VPC that resolves public DNS hostnames

to IP addresses is not enabled. If this attribute is true, queries to the Amazon

provided DNS server at the 169.254.169.253 IP address, or the reserved IP address

at the base of the VPC IPv4 network range plus two will succeed.

Type:boolean (optional)
maxAZs

Define the maximum number of AZs to use in this region

If the region has more AZs than you want to use (for example, because of EIP limits),

pick a lower number here. The AZs will be sorted and picked from the start of the list.

Type:number (optional)
Default:All AZs in the region
natGatewayPlacement

Configures the subnets which will have NAT Gateways

You can pick a specific group of subnets by specifying the group name;

the picked subnets must be public subnets.

Type:VpcPlacementStrategy (optional)
Default:All public subnets
natGateways

The number of NAT Gateways to create.

For example, if set this to 1 and your subnet configuration is for 3 Public subnets then only

one of the Public subnets will have a gateway and all Private subnets will route to this NAT Gateway.

Type:number (optional)
Default:maxAZs
subnetConfiguration

Configure the subnets to build for each AZ

The subnets are constructed in the context of the VPC so you only need

specify the configuration. The VPC details (VPC ID, specific CIDR,

specific AZ will be calculated during creation)

For example if you want 1 public subnet, 1 private subnet, and 1 isolated

subnet in each AZ provide the following:

subnetConfiguration: [

{

cidrMask: 24,

name: ‘ingress’,

subnetType: SubnetType.Public,

},

{

cidrMask: 24,

name: ‘application’,

subnetType: SubnetType.Private,

},

{

cidrMask: 28,

name: ‘rds’,

subnetType: SubnetType.Isolated,

}

]

cidrMask is optional and if not provided the IP space in the VPC will be

evenly divided between the requested subnets.

Type:SubnetConfiguration[] (optional)
Default:the VPC CIDR will be evenly divided between 1 public and 1

private subnet per AZ

@aws-cdk/aws-ec2.tags

The AWS resource tags to associate with the VPC.

Type:string => string (optional)

VpcNetworkProvider

class @aws-cdk/aws-ec2.VpcNetworkProvider(context, props)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.VpcNetworkProvider;
const { VpcNetworkProvider } = require('@aws-cdk/aws-ec2');
import { VpcNetworkProvider } from '@aws-cdk/aws-ec2';

Context provider to discover and import existing VPCs

Parameters:
vpcProps

Return the VPC import props matching the filter

Type:VpcNetworkRefProps (readonly)

VpcNetworkProviderProps (interface)

class @aws-cdk/aws-ec2.VpcNetworkProviderProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.VpcNetworkProviderProps;
// VpcNetworkProviderProps is an interface
import { VpcNetworkProviderProps } from '@aws-cdk/aws-ec2';

Properties for looking up an existing VPC.

The combination of properties must specify filter down to exactly one

non-default VPC, otherwise an error is raised.

isDefault

Whether to match the default VPC

Type:boolean (optional)
Default:Don’t care whether we return the default VPC
tags

Tags on the VPC

The VPC must have all of these tags

Type:string => string (optional)
Default:Don’t filter on tags
vpcId

The ID of the VPC

If given, will import exactly this VPC.

Type:string (optional)
Default:Don’t filter on vpcId
vpcName

The name of the VPC

If given, will import the VPC with this name.

Type:string (optional)
Default:Don’t filter on vpcName

VpcNetworkRef

class @aws-cdk/aws-ec2.VpcNetworkRef(parent, id)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.VpcNetworkRef;
const { VpcNetworkRef } = require('@aws-cdk/aws-ec2');
import { VpcNetworkRef } from '@aws-cdk/aws-ec2';

A new or imported VPC

Extends:

@aws-cdk/cdk.Construct

Implements:

@aws-cdk/cdk.IDependable

Abstract:

Yes

Parameters:
static import(parent, name, props) → @aws-cdk/aws-ec2.VpcNetworkRef

Import an exported VPC

Parameters:
Return type:

VpcNetworkRef

static importFromContext(parent, name, props) → @aws-cdk/aws-ec2.VpcNetworkRef

Import an existing VPC from context

Parameters:
Return type:

VpcNetworkRef

export() → @aws-cdk/aws-ec2.VpcNetworkRefProps

Export this VPC from the stack

Return type:VpcNetworkRefProps
internetDependency() → @aws-cdk/cdk.IDependable

Take a dependency on internet connectivity having been added to this VPC

Take a dependency on this if your constructs need an Internet Gateway

added to the VPC before they can be constructed.

This method is for construct authors; application builders should not

need to call this.

Return type:@aws-cdk/cdk.IDependable
isPublicSubnet(subnet) → boolean

Return whether the given subnet is one of this VPC’s public subnets.

The subnet must literally be one of the subnet object obtained from

this VPC. A subnet that merely represents the same subnet will

never return true.

Parameters:subnet (VpcSubnetRef) –
Return type:boolean
subnets([placement]) → @aws-cdk/aws-ec2.VpcSubnetRef[]

Return the subnets appropriate for the placement strategy

Parameters:placement (VpcPlacementStrategy (optional)) –
Return type:VpcSubnetRef[]
availabilityZones

AZs for this VPC

Type:string[] (readonly) (abstract)
dependencyElements

Implements @aws-cdk/cdk.IDependable.dependencyElements()

Parts of the VPC that constitute full construction

Type:@aws-cdk/cdk.IDependable[] (readonly)
internetDependencies

Dependencies for internet connectivity

Protected property

Type:@aws-cdk/cdk.IDependable[] (readonly)
isolatedSubnets

List of isolated subnets in this VPC

Type:VpcSubnetRef[] (readonly) (abstract)
privateSubnets

List of private subnets in this VPC

Type:VpcSubnetRef[] (readonly) (abstract)
publicSubnets

List of public subnets in this VPC

Type:VpcSubnetRef[] (readonly) (abstract)
vpcId

Identifier for this VPC

Type:string (readonly) (abstract)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)

VpcNetworkRefProps (interface)

class @aws-cdk/aws-ec2.VpcNetworkRefProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.VpcNetworkRefProps;
// VpcNetworkRefProps is an interface
import { VpcNetworkRefProps } from '@aws-cdk/aws-ec2';

Properties that reference an external VpcNetwork

availabilityZones

List of availability zones for the subnets in this VPC.

Type:string[]
vpcId

VPC’s identifier

Type:string
isolatedSubnetIds

List of isolated subnet IDs

Must be undefined or match the availability zones in length and order.

Type:string[] (optional)
isolatedSubnetNames

List of names for the isolated subnets

Must be undefined or have a name for every isolated subnet group.

Type:string[] (optional)
privateSubnetIds

List of private subnet IDs

Must be undefined or match the availability zones in length and order.

Type:string[] (optional)
privateSubnetNames

List of names for the private subnets

Must be undefined or have a name for every private subnet group.

Type:string[] (optional)
publicSubnetIds

List of public subnet IDs

Must be undefined or match the availability zones in length and order.

Type:string[] (optional)
publicSubnetNames

List of names for the public subnets

Must be undefined or have a name for every public subnet group.

Type:string[] (optional)

VpcPlacementStrategy (interface)

class @aws-cdk/aws-ec2.VpcPlacementStrategy

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.VpcPlacementStrategy;
// VpcPlacementStrategy is an interface
import { VpcPlacementStrategy } from '@aws-cdk/aws-ec2';

Customize how instances are placed inside a VPC

Constructs that allow customization of VPC placement use parameters of this

type to provide placement settings.

By default, the instances are placed in the private subnets.

subnetName

Place the instances in the subnets with the given name

(This is the name supplied in subnetConfiguration).

At most one of subnetsToUse and subnetName can be supplied.

Type:string (optional)
Default:name
subnetsToUse

Place the instances in the subnets of the given type

At most one of subnetsToUse and subnetName can be supplied.

Type:SubnetType (optional)
Default:SubnetType.Private

VpcPrivateSubnet

class @aws-cdk/aws-ec2.VpcPrivateSubnet(parent, name, props)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.VpcPrivateSubnet;
const { VpcPrivateSubnet } = require('@aws-cdk/aws-ec2');
import { VpcPrivateSubnet } from '@aws-cdk/aws-ec2';

Represents a private VPC subnet resource

Extends:

VpcSubnet

Parameters:
addDefaultNatRouteEntry(natGatewayId)

Adds an entry to this subnets route table that points to the passed NATGatwayId

Parameters:natGatewayId (string) –
addDefaultRouteToIGW(gateway, gatewayAttachment)

Inherited from @aws-cdk/aws-ec2.VpcSubnet

Create a default route that points to a passed IGW, with a dependency

on the IGW’s attachment to the VPC.

Protected method

Parameters:
addDefaultRouteToNAT(natGatewayId)

Inherited from @aws-cdk/aws-ec2.VpcSubnet

Protected method

Parameters:natGatewayId (string) –
availabilityZone

Inherited from @aws-cdk/aws-ec2.VpcSubnet

The Availability Zone the subnet is located in

Type:string (readonly)
subnetId

Inherited from @aws-cdk/aws-ec2.VpcSubnet

The subnetId for this particular subnet

Type:string (readonly)
tags

Inherited from @aws-cdk/aws-ec2.VpcSubnet

Manage tags for Construct and propagate to children

Type:@aws-cdk/cdk.TagManager (readonly)
dependencyElements

Inherited from @aws-cdk/aws-ec2.VpcSubnetRef

Parts of this VPC subnet

Type:@aws-cdk/cdk.IDependable[] (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)

VpcPublicSubnet

class @aws-cdk/aws-ec2.VpcPublicSubnet(parent, name, props)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.VpcPublicSubnet;
const { VpcPublicSubnet } = require('@aws-cdk/aws-ec2');
import { VpcPublicSubnet } from '@aws-cdk/aws-ec2';

Represents a public VPC subnet resource

Extends:

VpcSubnet

Parameters:
addDefaultIGWRouteEntry(gateway, gatewayAttachment)

Create a default route that points to a passed IGW, with a dependency

on the IGW’s attachment to the VPC.

Parameters:
addNatGateway() → string

Creates a new managed NAT gateway attached to this public subnet.

Also adds the EIP for the managed NAT.

Returns:A ref to the the NAT Gateway ID
Return type:string
addDefaultRouteToIGW(gateway, gatewayAttachment)

Inherited from @aws-cdk/aws-ec2.VpcSubnet

Create a default route that points to a passed IGW, with a dependency

on the IGW’s attachment to the VPC.

Protected method

Parameters:
addDefaultRouteToNAT(natGatewayId)

Inherited from @aws-cdk/aws-ec2.VpcSubnet

Protected method

Parameters:natGatewayId (string) –
availabilityZone

Inherited from @aws-cdk/aws-ec2.VpcSubnet

The Availability Zone the subnet is located in

Type:string (readonly)
subnetId

Inherited from @aws-cdk/aws-ec2.VpcSubnet

The subnetId for this particular subnet

Type:string (readonly)
tags

Inherited from @aws-cdk/aws-ec2.VpcSubnet

Manage tags for Construct and propagate to children

Type:@aws-cdk/cdk.TagManager (readonly)
dependencyElements

Inherited from @aws-cdk/aws-ec2.VpcSubnetRef

Parts of this VPC subnet

Type:@aws-cdk/cdk.IDependable[] (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)

VpcSubnet

class @aws-cdk/aws-ec2.VpcSubnet(parent, name, props)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.VpcSubnet;
const { VpcSubnet } = require('@aws-cdk/aws-ec2');
import { VpcSubnet } from '@aws-cdk/aws-ec2';

Represents a new VPC subnet resource

Extends:

VpcSubnetRef

Implements:

@aws-cdk/cdk.ITaggable

Parameters:
addDefaultRouteToIGW(gateway, gatewayAttachment)

Create a default route that points to a passed IGW, with a dependency

on the IGW’s attachment to the VPC.

Protected method

Parameters:
addDefaultRouteToNAT(natGatewayId)

Protected method

Parameters:natGatewayId (string) –
availabilityZone

Implements @aws-cdk/aws-ec2.VpcSubnetRef.availabilityZone()

The Availability Zone the subnet is located in

Type:string (readonly)
subnetId

Implements @aws-cdk/aws-ec2.VpcSubnetRef.subnetId()

The subnetId for this particular subnet

Type:string (readonly)
tags

Implements @aws-cdk/cdk.ITaggable.tags()

Manage tags for Construct and propagate to children

Type:@aws-cdk/cdk.TagManager (readonly)
dependencyElements

Inherited from @aws-cdk/aws-ec2.VpcSubnetRef

Parts of this VPC subnet

Type:@aws-cdk/cdk.IDependable[] (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)

VpcSubnetProps (interface)

class @aws-cdk/aws-ec2.VpcSubnetProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.VpcSubnetProps;
// VpcSubnetProps is an interface
import { VpcSubnetProps } from '@aws-cdk/aws-ec2';

Specify configuration parameters for a VPC subnet

availabilityZone

The availability zone for the subnet

Type:string
cidrBlock

The CIDR notation for this subnet

Type:string
vpcId

The VPC which this subnet is part of

Type:string
mapPublicIpOnLaunch

Controls if a public IP is associated to an instance at launch

Defaults to true in Subnet.Public, false in Subnet.Private or Subnet.Isolated.

Type:boolean (optional)
tags

The AWS resource tags to associate with the Subnet

Type:string => string (optional)

VpcSubnetRef

class @aws-cdk/aws-ec2.VpcSubnetRef(parent, id)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.VpcSubnetRef;
const { VpcSubnetRef } = require('@aws-cdk/aws-ec2');
import { VpcSubnetRef } from '@aws-cdk/aws-ec2';

A new or imported VPC Subnet

Extends:

@aws-cdk/cdk.Construct

Implements:

@aws-cdk/cdk.IDependable

Abstract:

Yes

Parameters:
static import(parent, name, props) → @aws-cdk/aws-ec2.VpcSubnetRef
Parameters:
Return type:

VpcSubnetRef

availabilityZone

The Availability Zone the subnet is located in

Type:string (readonly) (abstract)
dependencyElements

Implements @aws-cdk/cdk.IDependable.dependencyElements()

Parts of this VPC subnet

Type:@aws-cdk/cdk.IDependable[] (readonly)
subnetId

The subnetId for this particular subnet

Type:string (readonly) (abstract)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)

VpcSubnetRefProps (interface)

class @aws-cdk/aws-ec2.VpcSubnetRefProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.VpcSubnetRefProps;
// VpcSubnetRefProps is an interface
import { VpcSubnetRefProps } from '@aws-cdk/aws-ec2';
availabilityZone

The Availability Zone the subnet is located in

Type:string
subnetId

The subnetId for this particular subnet

Type:string

WindowsImage

class @aws-cdk/aws-ec2.WindowsImage(version)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.WindowsImage;
const { WindowsImage } = require('@aws-cdk/aws-ec2');
import { WindowsImage } from '@aws-cdk/aws-ec2';

Select the latest version of the indicated Windows version

The AMI ID is selected using the values published to the SSM parameter store.

https://aws.amazon.com/blogs/mt/query-for-the-latest-windows-ami-using-systems-manager-parameter-store/

Implements:IMachineImageSource
Parameters:version (WindowsVersion) –
getImage(parent) → @aws-cdk/aws-ec2.MachineImage

Implements @aws-cdk/aws-ec2.IMachineImageSource.getImage()

Return the image to use in the given context

Parameters:parent (@aws-cdk/cdk.Construct) –
Return type:MachineImage
version
Type:WindowsVersion (readonly)

WindowsOS

class @aws-cdk/aws-ec2.WindowsOS

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.WindowsOS;
const { WindowsOS } = require('@aws-cdk/aws-ec2');
import { WindowsOS } from '@aws-cdk/aws-ec2';

OS features specialized for Windows

Extends:OperatingSystem
createUserData(scripts) → string

Implements @aws-cdk/aws-ec2.OperatingSystem.createUserData()

Parameters:scripts (string[]) –
Return type:string
type

Implements @aws-cdk/aws-ec2.OperatingSystem.type()

Type:OperatingSystemType (readonly)

WindowsVersion (enum)

class @aws-cdk/aws-ec2.WindowsVersion

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.WindowsVersion;
const { WindowsVersion } = require('@aws-cdk/aws-ec2');
import { WindowsVersion } from '@aws-cdk/aws-ec2';

The Windows version to use for the WindowsImage

WindowsServer2016TurksihFullBase
WindowsServer2016SwedishFullBase
WindowsServer2016SpanishFullBase
WindowsServer2016RussianFullBase
WindowsServer2016PortuguesePortugalFullBase
WindowsServer2016PortugueseBrazilFullBase
WindowsServer2016PolishFullBase
WindowsServer2016KoreanFullSQL2016Base
WindowsServer2016KoreanFullBase
WindowsServer2016JapaneseFullSQL2016Web
WindowsServer2016JapaneseFullSQL2016Standard
WindowsServer2016JapaneseFullSQL2016Express
WindowsServer2016JapaneseFullSQL2016Enterprise
WindowsServer2016JapaneseFullBase
WindowsServer2016ItalianFullBase
WindowsServer2016HungarianFullBase
WindowsServer2016GermanFullBase
WindowsServer2016FrenchFullBase
WindowsServer2016EnglishNanoBase
WindowsServer2016EnglishFullSQL2017Web
WindowsServer2016EnglishFullSQL2017Standard
WindowsServer2016EnglishFullSQL2017Express
WindowsServer2016EnglishFullSQL2017Enterprise

cloudformation

CustomerGatewayResource

class @aws-cdk/aws-ec2.cloudformation.CustomerGatewayResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.CustomerGatewayResource;
const { cloudformation.CustomerGatewayResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.CustomerGatewayResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this CustomerGatewayResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (CustomerGatewayResourceProps) – the properties of this CustomerGatewayResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
customerGatewayName
Type:string (readonly)
propertyOverrides
Type:CustomerGatewayResourceProps (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

CustomerGatewayResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.CustomerGatewayResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.CustomerGatewayResourceProps;
// cloudformation.CustomerGatewayResourceProps is an interface
import { cloudformation.CustomerGatewayResourceProps } from '@aws-cdk/aws-ec2';
bgpAsn

AWS::EC2::CustomerGateway.BgpAsn

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-customer-gateway.html#cfn-ec2-customergateway-bgpasn

Type:number or @aws-cdk/cdk.Token
ipAddress

AWS::EC2::CustomerGateway.IpAddress

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-customer-gateway.html#cfn-ec2-customergateway-ipaddress

Type:string or @aws-cdk/cdk.Token
type

AWS::EC2::CustomerGateway.Type

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-customer-gateway.html#cfn-ec2-customergateway-type

Type:string or @aws-cdk/cdk.Token
tags

AWS::EC2::CustomerGateway.Tags

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-customer-gateway.html#cfn-ec2-customergateway-tags

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or @aws-cdk/cdk.Tag)[] (optional)

DHCPOptionsResource

class @aws-cdk/aws-ec2.cloudformation.DHCPOptionsResource(parent, name[, properties])

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.DHCPOptionsResource;
const { cloudformation.DHCPOptionsResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.DHCPOptionsResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this DHCPOptionsResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (DHCPOptionsResourceProps (optional)) – the properties of this DHCPOptionsResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
dhcpOptionsName
Type:string (readonly)
propertyOverrides
Type:DHCPOptionsResourceProps (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

DHCPOptionsResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.DHCPOptionsResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.DHCPOptionsResourceProps;
// cloudformation.DHCPOptionsResourceProps is an interface
import { cloudformation.DHCPOptionsResourceProps } from '@aws-cdk/aws-ec2';
domainName

AWS::EC2::DHCPOptions.DomainName

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-dhcp-options.html#cfn-ec2-dhcpoptions-domainname

Type:string or @aws-cdk/cdk.Token (optional)
domainNameServers

AWS::EC2::DHCPOptions.DomainNameServers

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-dhcp-options.html#cfn-ec2-dhcpoptions-domainnameservers

Type:@aws-cdk/cdk.Token or (string or @aws-cdk/cdk.Token)[] (optional)
netbiosNameServers

AWS::EC2::DHCPOptions.NetbiosNameServers

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-dhcp-options.html#cfn-ec2-dhcpoptions-netbiosnameservers

Type:@aws-cdk/cdk.Token or (string or @aws-cdk/cdk.Token)[] (optional)
netbiosNodeType

AWS::EC2::DHCPOptions.NetbiosNodeType

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-dhcp-options.html#cfn-ec2-dhcpoptions-netbiosnodetype

Type:number or @aws-cdk/cdk.Token (optional)
ntpServers

AWS::EC2::DHCPOptions.NtpServers

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-dhcp-options.html#cfn-ec2-dhcpoptions-ntpservers

Type:@aws-cdk/cdk.Token or (string or @aws-cdk/cdk.Token)[] (optional)
tags

AWS::EC2::DHCPOptions.Tags

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-dhcp-options.html#cfn-ec2-dhcpoptions-tags

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or @aws-cdk/cdk.Tag)[] (optional)

EC2FleetResource

class @aws-cdk/aws-ec2.cloudformation.EC2FleetResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.EC2FleetResource;
const { cloudformation.EC2FleetResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.EC2FleetResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this EC2FleetResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (EC2FleetResourceProps) – the properties of this EC2FleetResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
ec2FleetId
Type:string (readonly)
propertyOverrides
Type:EC2FleetResourceProps (readonly)
class FleetLaunchTemplateConfigRequestProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.EC2FleetResource.FleetLaunchTemplateConfigRequestProperty;
// cloudformation.EC2FleetResource.FleetLaunchTemplateConfigRequestProperty is an interface
import { cloudformation.EC2FleetResource.FleetLaunchTemplateConfigRequestProperty } from '@aws-cdk/aws-ec2';
launchTemplateSpecification

EC2FleetResource.FleetLaunchTemplateConfigRequestProperty.LaunchTemplateSpecification

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-fleetlaunchtemplateconfigrequest.html#cfn-ec2-ec2fleet-fleetlaunchtemplateconfigrequest-launchtemplatespecification

Type:@aws-cdk/cdk.Token or FleetLaunchTemplateSpecificationRequestProperty (optional)
overrides

EC2FleetResource.FleetLaunchTemplateConfigRequestProperty.Overrides

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-fleetlaunchtemplateconfigrequest.html#cfn-ec2-ec2fleet-fleetlaunchtemplateconfigrequest-overrides

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or FleetLaunchTemplateOverridesRequestProperty)[] (optional)
class FleetLaunchTemplateOverridesRequestProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.EC2FleetResource.FleetLaunchTemplateOverridesRequestProperty;
// cloudformation.EC2FleetResource.FleetLaunchTemplateOverridesRequestProperty is an interface
import { cloudformation.EC2FleetResource.FleetLaunchTemplateOverridesRequestProperty } from '@aws-cdk/aws-ec2';
availabilityZone

EC2FleetResource.FleetLaunchTemplateOverridesRequestProperty.AvailabilityZone

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest.html#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-availabilityzone

Type:string or @aws-cdk/cdk.Token (optional)
instanceType

EC2FleetResource.FleetLaunchTemplateOverridesRequestProperty.InstanceType

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest.html#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-instancetype

Type:string or @aws-cdk/cdk.Token (optional)
maxPrice

EC2FleetResource.FleetLaunchTemplateOverridesRequestProperty.MaxPrice

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest.html#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-maxprice

Type:string or @aws-cdk/cdk.Token (optional)
priority

EC2FleetResource.FleetLaunchTemplateOverridesRequestProperty.Priority

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest.html#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-priority

Type:number or @aws-cdk/cdk.Token (optional)
subnetId

EC2FleetResource.FleetLaunchTemplateOverridesRequestProperty.SubnetId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest.html#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-subnetid

Type:string or @aws-cdk/cdk.Token (optional)
weightedCapacity

EC2FleetResource.FleetLaunchTemplateOverridesRequestProperty.WeightedCapacity

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest.html#cfn-ec2-ec2fleet-fleetlaunchtemplateoverridesrequest-weightedcapacity

Type:number or @aws-cdk/cdk.Token (optional)
class FleetLaunchTemplateSpecificationRequestProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.EC2FleetResource.FleetLaunchTemplateSpecificationRequestProperty;
// cloudformation.EC2FleetResource.FleetLaunchTemplateSpecificationRequestProperty is an interface
import { cloudformation.EC2FleetResource.FleetLaunchTemplateSpecificationRequestProperty } from '@aws-cdk/aws-ec2';
launchTemplateId

EC2FleetResource.FleetLaunchTemplateSpecificationRequestProperty.LaunchTemplateId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-fleetlaunchtemplatespecificationrequest.html#cfn-ec2-ec2fleet-fleetlaunchtemplatespecificationrequest-launchtemplateid

Type:string or @aws-cdk/cdk.Token (optional)
launchTemplateName

EC2FleetResource.FleetLaunchTemplateSpecificationRequestProperty.LaunchTemplateName

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-fleetlaunchtemplatespecificationrequest.html#cfn-ec2-ec2fleet-fleetlaunchtemplatespecificationrequest-launchtemplatename

Type:string or @aws-cdk/cdk.Token (optional)
version

EC2FleetResource.FleetLaunchTemplateSpecificationRequestProperty.Version

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-fleetlaunchtemplatespecificationrequest.html#cfn-ec2-ec2fleet-fleetlaunchtemplatespecificationrequest-version

Type:string or @aws-cdk/cdk.Token (optional)
class OnDemandOptionsRequestProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.EC2FleetResource.OnDemandOptionsRequestProperty;
// cloudformation.EC2FleetResource.OnDemandOptionsRequestProperty is an interface
import { cloudformation.EC2FleetResource.OnDemandOptionsRequestProperty } from '@aws-cdk/aws-ec2';
allocationStrategy

EC2FleetResource.OnDemandOptionsRequestProperty.AllocationStrategy

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-ondemandoptionsrequest.html#cfn-ec2-ec2fleet-ondemandoptionsrequest-allocationstrategy

Type:string or @aws-cdk/cdk.Token (optional)
class SpotOptionsRequestProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.EC2FleetResource.SpotOptionsRequestProperty;
// cloudformation.EC2FleetResource.SpotOptionsRequestProperty is an interface
import { cloudformation.EC2FleetResource.SpotOptionsRequestProperty } from '@aws-cdk/aws-ec2';
allocationStrategy

EC2FleetResource.SpotOptionsRequestProperty.AllocationStrategy

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-spotoptionsrequest.html#cfn-ec2-ec2fleet-spotoptionsrequest-allocationstrategy

Type:string or @aws-cdk/cdk.Token (optional)
instanceInterruptionBehavior

EC2FleetResource.SpotOptionsRequestProperty.InstanceInterruptionBehavior

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-spotoptionsrequest.html#cfn-ec2-ec2fleet-spotoptionsrequest-instanceinterruptionbehavior

Type:string or @aws-cdk/cdk.Token (optional)
instancePoolsToUseCount

EC2FleetResource.SpotOptionsRequestProperty.InstancePoolsToUseCount

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-spotoptionsrequest.html#cfn-ec2-ec2fleet-spotoptionsrequest-instancepoolstousecount

Type:number or @aws-cdk/cdk.Token (optional)
class TagRequestProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.EC2FleetResource.TagRequestProperty;
// cloudformation.EC2FleetResource.TagRequestProperty is an interface
import { cloudformation.EC2FleetResource.TagRequestProperty } from '@aws-cdk/aws-ec2';
key

EC2FleetResource.TagRequestProperty.Key

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-tagrequest.html#cfn-ec2-ec2fleet-tagrequest-key

Type:string or @aws-cdk/cdk.Token (optional)
value

EC2FleetResource.TagRequestProperty.Value

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-tagrequest.html#cfn-ec2-ec2fleet-tagrequest-value

Type:string or @aws-cdk/cdk.Token (optional)
class TagSpecificationProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.EC2FleetResource.TagSpecificationProperty;
// cloudformation.EC2FleetResource.TagSpecificationProperty is an interface
import { cloudformation.EC2FleetResource.TagSpecificationProperty } from '@aws-cdk/aws-ec2';
resourceType

EC2FleetResource.TagSpecificationProperty.ResourceType

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-tagspecification.html#cfn-ec2-ec2fleet-tagspecification-resourcetype

Type:string or @aws-cdk/cdk.Token (optional)
tags

EC2FleetResource.TagSpecificationProperty.Tags

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-tagspecification.html#cfn-ec2-ec2fleet-tagspecification-tags

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or TagRequestProperty)[] (optional)
class TargetCapacitySpecificationRequestProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.EC2FleetResource.TargetCapacitySpecificationRequestProperty;
// cloudformation.EC2FleetResource.TargetCapacitySpecificationRequestProperty is an interface
import { cloudformation.EC2FleetResource.TargetCapacitySpecificationRequestProperty } from '@aws-cdk/aws-ec2';
totalTargetCapacity

EC2FleetResource.TargetCapacitySpecificationRequestProperty.TotalTargetCapacity

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-targetcapacityspecificationrequest.html#cfn-ec2-ec2fleet-targetcapacityspecificationrequest-totaltargetcapacity

Type:number or @aws-cdk/cdk.Token
defaultTargetCapacityType

EC2FleetResource.TargetCapacitySpecificationRequestProperty.DefaultTargetCapacityType

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-targetcapacityspecificationrequest.html#cfn-ec2-ec2fleet-targetcapacityspecificationrequest-defaulttargetcapacitytype

Type:string or @aws-cdk/cdk.Token (optional)
onDemandTargetCapacity

EC2FleetResource.TargetCapacitySpecificationRequestProperty.OnDemandTargetCapacity

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-targetcapacityspecificationrequest.html#cfn-ec2-ec2fleet-targetcapacityspecificationrequest-ondemandtargetcapacity

Type:number or @aws-cdk/cdk.Token (optional)
spotTargetCapacity

EC2FleetResource.TargetCapacitySpecificationRequestProperty.SpotTargetCapacity

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ec2fleet-targetcapacityspecificationrequest.html#cfn-ec2-ec2fleet-targetcapacityspecificationrequest-spottargetcapacity

Type:number or @aws-cdk/cdk.Token (optional)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

EC2FleetResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.EC2FleetResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.EC2FleetResourceProps;
// cloudformation.EC2FleetResourceProps is an interface
import { cloudformation.EC2FleetResourceProps } from '@aws-cdk/aws-ec2';
launchTemplateConfigs

AWS::EC2::EC2Fleet.LaunchTemplateConfigs

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-ec2fleet.html#cfn-ec2-ec2fleet-launchtemplateconfigs

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or FleetLaunchTemplateConfigRequestProperty)[]
targetCapacitySpecification

AWS::EC2::EC2Fleet.TargetCapacitySpecification

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-ec2fleet.html#cfn-ec2-ec2fleet-targetcapacityspecification

Type:@aws-cdk/cdk.Token or TargetCapacitySpecificationRequestProperty
excessCapacityTerminationPolicy

AWS::EC2::EC2Fleet.ExcessCapacityTerminationPolicy

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-ec2fleet.html#cfn-ec2-ec2fleet-excesscapacityterminationpolicy

Type:string or @aws-cdk/cdk.Token (optional)
onDemandOptions

AWS::EC2::EC2Fleet.OnDemandOptions

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-ec2fleet.html#cfn-ec2-ec2fleet-ondemandoptions

Type:@aws-cdk/cdk.Token or OnDemandOptionsRequestProperty (optional)
replaceUnhealthyInstances

AWS::EC2::EC2Fleet.ReplaceUnhealthyInstances

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-ec2fleet.html#cfn-ec2-ec2fleet-replaceunhealthyinstances

Type:boolean or @aws-cdk/cdk.Token (optional)
spotOptions

AWS::EC2::EC2Fleet.SpotOptions

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-ec2fleet.html#cfn-ec2-ec2fleet-spotoptions

Type:@aws-cdk/cdk.Token or SpotOptionsRequestProperty (optional)
tagSpecifications

AWS::EC2::EC2Fleet.TagSpecifications

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-ec2fleet.html#cfn-ec2-ec2fleet-tagspecifications

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or TagSpecificationProperty)[] (optional)
terminateInstancesWithExpiration

AWS::EC2::EC2Fleet.TerminateInstancesWithExpiration

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-ec2fleet.html#cfn-ec2-ec2fleet-terminateinstanceswithexpiration

Type:boolean or @aws-cdk/cdk.Token (optional)
type

AWS::EC2::EC2Fleet.Type

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-ec2fleet.html#cfn-ec2-ec2fleet-type

Type:string or @aws-cdk/cdk.Token (optional)
validFrom

AWS::EC2::EC2Fleet.ValidFrom

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-ec2fleet.html#cfn-ec2-ec2fleet-validfrom

Type:number or @aws-cdk/cdk.Token (optional)
validUntil

AWS::EC2::EC2Fleet.ValidUntil

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-ec2fleet.html#cfn-ec2-ec2fleet-validuntil

Type:number or @aws-cdk/cdk.Token (optional)

EIPAssociationResource

class @aws-cdk/aws-ec2.cloudformation.EIPAssociationResource(parent, name[, properties])

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.EIPAssociationResource;
const { cloudformation.EIPAssociationResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.EIPAssociationResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this EIPAssociationResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (EIPAssociationResourceProps (optional)) – the properties of this EIPAssociationResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
eipAssociationName
Type:string (readonly)
propertyOverrides
Type:EIPAssociationResourceProps (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

EIPAssociationResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.EIPAssociationResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.EIPAssociationResourceProps;
// cloudformation.EIPAssociationResourceProps is an interface
import { cloudformation.EIPAssociationResourceProps } from '@aws-cdk/aws-ec2';
allocationId

AWS::EC2::EIPAssociation.AllocationId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-eip-association.html#cfn-ec2-eipassociation-allocationid

Type:string or @aws-cdk/cdk.Token (optional)
eip

AWS::EC2::EIPAssociation.EIP

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-eip-association.html#cfn-ec2-eipassociation-eip

Type:string or @aws-cdk/cdk.Token (optional)
instanceId

AWS::EC2::EIPAssociation.InstanceId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-eip-association.html#cfn-ec2-eipassociation-instanceid

Type:string or @aws-cdk/cdk.Token (optional)
networkInterfaceId

AWS::EC2::EIPAssociation.NetworkInterfaceId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-eip-association.html#cfn-ec2-eipassociation-networkinterfaceid

Type:string or @aws-cdk/cdk.Token (optional)
privateIpAddress

AWS::EC2::EIPAssociation.PrivateIpAddress

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-eip-association.html#cfn-ec2-eipassociation-PrivateIpAddress

Type:string or @aws-cdk/cdk.Token (optional)

EIPResource

class @aws-cdk/aws-ec2.cloudformation.EIPResource(parent, name[, properties])

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.EIPResource;
const { cloudformation.EIPResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.EIPResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this EIPResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (EIPResourceProps (optional)) – the properties of this EIPResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
eipAllocationId
Type:string (readonly)
eipIp
Type:string (readonly)
propertyOverrides
Type:EIPResourceProps (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

EIPResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.EIPResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.EIPResourceProps;
// cloudformation.EIPResourceProps is an interface
import { cloudformation.EIPResourceProps } from '@aws-cdk/aws-ec2';
domain

AWS::EC2::EIP.Domain

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-eip.html#cfn-ec2-eip-domain

Type:string or @aws-cdk/cdk.Token (optional)
instanceId

AWS::EC2::EIP.InstanceId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-eip.html#cfn-ec2-eip-instanceid

Type:string or @aws-cdk/cdk.Token (optional)
publicIpv4Pool

AWS::EC2::EIP.PublicIpv4Pool

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-eip.html#cfn-ec2-eip-publicipv4pool

Type:string or @aws-cdk/cdk.Token (optional)

EgressOnlyInternetGatewayResource

class @aws-cdk/aws-ec2.cloudformation.EgressOnlyInternetGatewayResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.EgressOnlyInternetGatewayResource;
const { cloudformation.EgressOnlyInternetGatewayResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.EgressOnlyInternetGatewayResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
egressOnlyInternetGatewayId
Type:string (readonly)
propertyOverrides
Type:EgressOnlyInternetGatewayResourceProps (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

EgressOnlyInternetGatewayResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.EgressOnlyInternetGatewayResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.EgressOnlyInternetGatewayResourceProps;
// cloudformation.EgressOnlyInternetGatewayResourceProps is an interface
import { cloudformation.EgressOnlyInternetGatewayResourceProps } from '@aws-cdk/aws-ec2';
vpcId

AWS::EC2::EgressOnlyInternetGateway.VpcId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-egressonlyinternetgateway.html#cfn-ec2-egressonlyinternetgateway-vpcid

Type:string or @aws-cdk/cdk.Token

FlowLogResource

class @aws-cdk/aws-ec2.cloudformation.FlowLogResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.FlowLogResource;
const { cloudformation.FlowLogResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.FlowLogResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this FlowLogResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (FlowLogResourceProps) – the properties of this FlowLogResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
flowLogId
Type:string (readonly)
propertyOverrides
Type:FlowLogResourceProps (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

FlowLogResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.FlowLogResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.FlowLogResourceProps;
// cloudformation.FlowLogResourceProps is an interface
import { cloudformation.FlowLogResourceProps } from '@aws-cdk/aws-ec2';
resourceId

AWS::EC2::FlowLog.ResourceId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-flowlog.html#cfn-ec2-flowlog-resourceid

Type:string or @aws-cdk/cdk.Token
resourceType

AWS::EC2::FlowLog.ResourceType

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-flowlog.html#cfn-ec2-flowlog-resourcetype

Type:string or @aws-cdk/cdk.Token
trafficType

AWS::EC2::FlowLog.TrafficType

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-flowlog.html#cfn-ec2-flowlog-traffictype

Type:string or @aws-cdk/cdk.Token
deliverLogsPermissionArn

AWS::EC2::FlowLog.DeliverLogsPermissionArn

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-flowlog.html#cfn-ec2-flowlog-deliverlogspermissionarn

Type:string or @aws-cdk/cdk.Token (optional)
logDestination

AWS::EC2::FlowLog.LogDestination

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-flowlog.html#cfn-ec2-flowlog-logdestination

Type:string or @aws-cdk/cdk.Token (optional)
logDestinationType

AWS::EC2::FlowLog.LogDestinationType

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-flowlog.html#cfn-ec2-flowlog-logdestinationtype

Type:string or @aws-cdk/cdk.Token (optional)
logGroupName

AWS::EC2::FlowLog.LogGroupName

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-flowlog.html#cfn-ec2-flowlog-loggroupname

Type:string or @aws-cdk/cdk.Token (optional)

HostResource

class @aws-cdk/aws-ec2.cloudformation.HostResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.HostResource;
const { cloudformation.HostResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.HostResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this HostResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (HostResourceProps) – the properties of this HostResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
hostId
Type:string (readonly)
propertyOverrides
Type:HostResourceProps (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

HostResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.HostResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.HostResourceProps;
// cloudformation.HostResourceProps is an interface
import { cloudformation.HostResourceProps } from '@aws-cdk/aws-ec2';
availabilityZone

AWS::EC2::Host.AvailabilityZone

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-host.html#cfn-ec2-host-availabilityzone

Type:string or @aws-cdk/cdk.Token
instanceType

AWS::EC2::Host.InstanceType

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-host.html#cfn-ec2-host-instancetype

Type:string or @aws-cdk/cdk.Token
autoPlacement

AWS::EC2::Host.AutoPlacement

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-host.html#cfn-ec2-host-autoplacement

Type:string or @aws-cdk/cdk.Token (optional)

InstanceResource

class @aws-cdk/aws-ec2.cloudformation.InstanceResource(parent, name[, properties])

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.InstanceResource;
const { cloudformation.InstanceResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.InstanceResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this InstanceResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (InstanceResourceProps (optional)) – the properties of this InstanceResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
instanceAvailabilityZone
Type:string (readonly)
instanceId
Type:string (readonly)
instancePrivateDnsName
Type:string (readonly)
instancePrivateIp
Type:string (readonly)
instancePublicDnsName
Type:string (readonly)
instancePublicIp
Type:string (readonly)
propertyOverrides
Type:InstanceResourceProps (readonly)
class AssociationParameterProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.InstanceResource.AssociationParameterProperty;
// cloudformation.InstanceResource.AssociationParameterProperty is an interface
import { cloudformation.InstanceResource.AssociationParameterProperty } from '@aws-cdk/aws-ec2';
key

InstanceResource.AssociationParameterProperty.Key

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance-ssmassociations-associationparameters.html#cfn-ec2-instance-ssmassociations-associationparameters-key

Type:string or @aws-cdk/cdk.Token
value

InstanceResource.AssociationParameterProperty.Value

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance-ssmassociations-associationparameters.html#cfn-ec2-instance-ssmassociations-associationparameters-value

Type:@aws-cdk/cdk.Token or (string or @aws-cdk/cdk.Token)[]
class BlockDeviceMappingProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.InstanceResource.BlockDeviceMappingProperty;
// cloudformation.InstanceResource.BlockDeviceMappingProperty is an interface
import { cloudformation.InstanceResource.BlockDeviceMappingProperty } from '@aws-cdk/aws-ec2';
deviceName

InstanceResource.BlockDeviceMappingProperty.DeviceName

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-blockdev-mapping.html#cfn-ec2-blockdev-mapping-devicename

Type:string or @aws-cdk/cdk.Token
ebs

InstanceResource.BlockDeviceMappingProperty.Ebs

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-blockdev-mapping.html#cfn-ec2-blockdev-mapping-ebs

Type:@aws-cdk/cdk.Token or EbsProperty (optional)
noDevice

InstanceResource.BlockDeviceMappingProperty.NoDevice

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-blockdev-mapping.html#cfn-ec2-blockdev-mapping-nodevice

Type:@aws-cdk/cdk.Token or NoDeviceProperty (optional)
virtualName

InstanceResource.BlockDeviceMappingProperty.VirtualName

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-blockdev-mapping.html#cfn-ec2-blockdev-mapping-virtualname

Type:string or @aws-cdk/cdk.Token (optional)
class CreditSpecificationProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.InstanceResource.CreditSpecificationProperty;
// cloudformation.InstanceResource.CreditSpecificationProperty is an interface
import { cloudformation.InstanceResource.CreditSpecificationProperty } from '@aws-cdk/aws-ec2';
cpuCredits

InstanceResource.CreditSpecificationProperty.CPUCredits

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance-creditspecification.html#cfn-ec2-instance-creditspecification-cpucredits

Type:string or @aws-cdk/cdk.Token (optional)
class EbsProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.InstanceResource.EbsProperty;
// cloudformation.InstanceResource.EbsProperty is an interface
import { cloudformation.InstanceResource.EbsProperty } from '@aws-cdk/aws-ec2';
deleteOnTermination

InstanceResource.EbsProperty.DeleteOnTermination

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-blockdev-template.html#cfn-ec2-blockdev-template-deleteontermination

Type:boolean or @aws-cdk/cdk.Token (optional)
encrypted

InstanceResource.EbsProperty.Encrypted

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-blockdev-template.html#cfn-ec2-blockdev-template-encrypted

Type:boolean or @aws-cdk/cdk.Token (optional)
iops

InstanceResource.EbsProperty.Iops

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-blockdev-template.html#cfn-ec2-blockdev-template-iops

Type:number or @aws-cdk/cdk.Token (optional)
snapshotId

InstanceResource.EbsProperty.SnapshotId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-blockdev-template.html#cfn-ec2-blockdev-template-snapshotid

Type:string or @aws-cdk/cdk.Token (optional)
volumeSize

InstanceResource.EbsProperty.VolumeSize

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-blockdev-template.html#cfn-ec2-blockdev-template-volumesize

Type:number or @aws-cdk/cdk.Token (optional)
volumeType

InstanceResource.EbsProperty.VolumeType

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-blockdev-template.html#cfn-ec2-blockdev-template-volumetype

Type:string or @aws-cdk/cdk.Token (optional)
class ElasticGpuSpecificationProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.InstanceResource.ElasticGpuSpecificationProperty;
// cloudformation.InstanceResource.ElasticGpuSpecificationProperty is an interface
import { cloudformation.InstanceResource.ElasticGpuSpecificationProperty } from '@aws-cdk/aws-ec2';
type

InstanceResource.ElasticGpuSpecificationProperty.Type

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance-elasticgpuspecification.html#cfn-ec2-instance-elasticgpuspecification-type

Type:string or @aws-cdk/cdk.Token
class ElasticInferenceAcceleratorProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.InstanceResource.ElasticInferenceAcceleratorProperty;
// cloudformation.InstanceResource.ElasticInferenceAcceleratorProperty is an interface
import { cloudformation.InstanceResource.ElasticInferenceAcceleratorProperty } from '@aws-cdk/aws-ec2';
type

InstanceResource.ElasticInferenceAcceleratorProperty.Type

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance-elasticinferenceaccelerator.html#cfn-ec2-instance-elasticinferenceaccelerator-type

Type:string or @aws-cdk/cdk.Token
class InstanceIpv6AddressProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.InstanceResource.InstanceIpv6AddressProperty;
// cloudformation.InstanceResource.InstanceIpv6AddressProperty is an interface
import { cloudformation.InstanceResource.InstanceIpv6AddressProperty } from '@aws-cdk/aws-ec2';
ipv6Address

InstanceResource.InstanceIpv6AddressProperty.Ipv6Address

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance-instanceipv6address.html#cfn-ec2-instance-instanceipv6address-ipv6address

Type:string or @aws-cdk/cdk.Token
class LaunchTemplateSpecificationProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.InstanceResource.LaunchTemplateSpecificationProperty;
// cloudformation.InstanceResource.LaunchTemplateSpecificationProperty is an interface
import { cloudformation.InstanceResource.LaunchTemplateSpecificationProperty } from '@aws-cdk/aws-ec2';
version

InstanceResource.LaunchTemplateSpecificationProperty.Version

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance-launchtemplatespecification.html#cfn-ec2-instance-launchtemplatespecification-version

Type:string or @aws-cdk/cdk.Token
launchTemplateId

InstanceResource.LaunchTemplateSpecificationProperty.LaunchTemplateId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance-launchtemplatespecification.html#cfn-ec2-instance-launchtemplatespecification-launchtemplateid

Type:string or @aws-cdk/cdk.Token (optional)
launchTemplateName

InstanceResource.LaunchTemplateSpecificationProperty.LaunchTemplateName

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance-launchtemplatespecification.html#cfn-ec2-instance-launchtemplatespecification-launchtemplatename

Type:string or @aws-cdk/cdk.Token (optional)
class LicenseSpecificationProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.InstanceResource.LicenseSpecificationProperty;
// cloudformation.InstanceResource.LicenseSpecificationProperty is an interface
import { cloudformation.InstanceResource.LicenseSpecificationProperty } from '@aws-cdk/aws-ec2';
licenseConfigurationArn

InstanceResource.LicenseSpecificationProperty.LicenseConfigurationArn

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance-licensespecification.html#cfn-ec2-instance-licensespecification-licenseconfigurationarn

Type:string or @aws-cdk/cdk.Token
class NetworkInterfaceProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.InstanceResource.NetworkInterfaceProperty;
// cloudformation.InstanceResource.NetworkInterfaceProperty is an interface
import { cloudformation.InstanceResource.NetworkInterfaceProperty } from '@aws-cdk/aws-ec2';
deviceIndex

InstanceResource.NetworkInterfaceProperty.DeviceIndex

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-network-iface-embedded.html#aws-properties-ec2-network-iface-embedded-deviceindex

Type:string or @aws-cdk/cdk.Token
associatePublicIpAddress

InstanceResource.NetworkInterfaceProperty.AssociatePublicIpAddress

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-network-iface-embedded.html#aws-properties-ec2-network-iface-embedded-associatepubip

Type:boolean or @aws-cdk/cdk.Token (optional)
deleteOnTermination

InstanceResource.NetworkInterfaceProperty.DeleteOnTermination

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-network-iface-embedded.html#aws-properties-ec2-network-iface-embedded-delete

Type:boolean or @aws-cdk/cdk.Token (optional)
description

InstanceResource.NetworkInterfaceProperty.Description

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-network-iface-embedded.html#aws-properties-ec2-network-iface-embedded-description

Type:string or @aws-cdk/cdk.Token (optional)
groupSet

InstanceResource.NetworkInterfaceProperty.GroupSet

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-network-iface-embedded.html#aws-properties-ec2-network-iface-embedded-groupset

Type:@aws-cdk/cdk.Token or (string or @aws-cdk/cdk.Token)[] (optional)
ipv6AddressCount

InstanceResource.NetworkInterfaceProperty.Ipv6AddressCount

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-network-iface-embedded.html#cfn-ec2-instance-networkinterface-ipv6addresscount

Type:number or @aws-cdk/cdk.Token (optional)
ipv6Addresses

InstanceResource.NetworkInterfaceProperty.Ipv6Addresses

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-network-iface-embedded.html#cfn-ec2-instance-networkinterface-ipv6addresses

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or InstanceIpv6AddressProperty)[] (optional)
networkInterfaceId

InstanceResource.NetworkInterfaceProperty.NetworkInterfaceId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-network-iface-embedded.html#aws-properties-ec2-network-iface-embedded-network-iface

Type:string or @aws-cdk/cdk.Token (optional)
privateIpAddress

InstanceResource.NetworkInterfaceProperty.PrivateIpAddress

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-network-iface-embedded.html#aws-properties-ec2-network-iface-embedded-privateipaddress

Type:string or @aws-cdk/cdk.Token (optional)
privateIpAddresses

InstanceResource.NetworkInterfaceProperty.PrivateIpAddresses

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-network-iface-embedded.html#aws-properties-ec2-network-iface-embedded-privateipaddresses

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or PrivateIpAddressSpecificationProperty)[] (optional)
secondaryPrivateIpAddressCount

InstanceResource.NetworkInterfaceProperty.SecondaryPrivateIpAddressCount

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-network-iface-embedded.html#aws-properties-ec2-network-iface-embedded-secondprivateip

Type:number or @aws-cdk/cdk.Token (optional)
subnetId

InstanceResource.NetworkInterfaceProperty.SubnetId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-network-iface-embedded.html#aws-properties-ec2-network-iface-embedded-subnetid

Type:string or @aws-cdk/cdk.Token (optional)
class NoDeviceProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.InstanceResource.NoDeviceProperty;
// cloudformation.InstanceResource.NoDeviceProperty is an interface
import { cloudformation.InstanceResource.NoDeviceProperty } from '@aws-cdk/aws-ec2';
class PrivateIpAddressSpecificationProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.InstanceResource.PrivateIpAddressSpecificationProperty;
// cloudformation.InstanceResource.PrivateIpAddressSpecificationProperty is an interface
import { cloudformation.InstanceResource.PrivateIpAddressSpecificationProperty } from '@aws-cdk/aws-ec2';
primary

InstanceResource.PrivateIpAddressSpecificationProperty.Primary

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-network-interface-privateipspec.html#cfn-ec2-networkinterface-privateipspecification-primary

Type:boolean or @aws-cdk/cdk.Token
privateIpAddress

InstanceResource.PrivateIpAddressSpecificationProperty.PrivateIpAddress

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-network-interface-privateipspec.html#cfn-ec2-networkinterface-privateipspecification-privateipaddress

Type:string or @aws-cdk/cdk.Token
class SsmAssociationProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.InstanceResource.SsmAssociationProperty;
// cloudformation.InstanceResource.SsmAssociationProperty is an interface
import { cloudformation.InstanceResource.SsmAssociationProperty } from '@aws-cdk/aws-ec2';
documentName

InstanceResource.SsmAssociationProperty.DocumentName

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance-ssmassociations.html#cfn-ec2-instance-ssmassociations-documentname

Type:string or @aws-cdk/cdk.Token
associationParameters

InstanceResource.SsmAssociationProperty.AssociationParameters

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance-ssmassociations.html#cfn-ec2-instance-ssmassociations-associationparameters

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or AssociationParameterProperty)[] (optional)
class VolumeProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.InstanceResource.VolumeProperty;
// cloudformation.InstanceResource.VolumeProperty is an interface
import { cloudformation.InstanceResource.VolumeProperty } from '@aws-cdk/aws-ec2';
device

InstanceResource.VolumeProperty.Device

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-mount-point.html#cfn-ec2-mountpoint-device

Type:string or @aws-cdk/cdk.Token
volumeId

InstanceResource.VolumeProperty.VolumeId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-mount-point.html#cfn-ec2-mountpoint-volumeid

Type:string or @aws-cdk/cdk.Token
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

InstanceResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.InstanceResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.InstanceResourceProps;
// cloudformation.InstanceResourceProps is an interface
import { cloudformation.InstanceResourceProps } from '@aws-cdk/aws-ec2';
additionalInfo

AWS::EC2::Instance.AdditionalInfo

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-additionalinfo

Type:string or @aws-cdk/cdk.Token (optional)
affinity

AWS::EC2::Instance.Affinity

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-affinity

Type:string or @aws-cdk/cdk.Token (optional)
availabilityZone

AWS::EC2::Instance.AvailabilityZone

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-availabilityzone

Type:string or @aws-cdk/cdk.Token (optional)
blockDeviceMappings

AWS::EC2::Instance.BlockDeviceMappings

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-blockdevicemappings

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or BlockDeviceMappingProperty)[] (optional)
creditSpecification

AWS::EC2::Instance.CreditSpecification

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-creditspecification

Type:@aws-cdk/cdk.Token or CreditSpecificationProperty (optional)
disableApiTermination

AWS::EC2::Instance.DisableApiTermination

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-disableapitermination

Type:boolean or @aws-cdk/cdk.Token (optional)
ebsOptimized

AWS::EC2::Instance.EbsOptimized

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-ebsoptimized

Type:boolean or @aws-cdk/cdk.Token (optional)
elasticGpuSpecifications

AWS::EC2::Instance.ElasticGpuSpecifications

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-elasticgpuspecifications

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or ElasticGpuSpecificationProperty)[] (optional)
elasticInferenceAccelerators

AWS::EC2::Instance.ElasticInferenceAccelerators

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-elasticinferenceaccelerators

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or ElasticInferenceAcceleratorProperty)[] (optional)
hostId

AWS::EC2::Instance.HostId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-hostid

Type:string or @aws-cdk/cdk.Token (optional)
iamInstanceProfile

AWS::EC2::Instance.IamInstanceProfile

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-iaminstanceprofile

Type:string or @aws-cdk/cdk.Token (optional)
imageId

AWS::EC2::Instance.ImageId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-imageid

Type:string or @aws-cdk/cdk.Token (optional)
instanceInitiatedShutdownBehavior

AWS::EC2::Instance.InstanceInitiatedShutdownBehavior

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-instanceinitiatedshutdownbehavior

Type:string or @aws-cdk/cdk.Token (optional)
instanceType

AWS::EC2::Instance.InstanceType

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-instancetype

Type:string or @aws-cdk/cdk.Token (optional)
ipv6AddressCount

AWS::EC2::Instance.Ipv6AddressCount

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-ipv6addresscount

Type:number or @aws-cdk/cdk.Token (optional)
ipv6Addresses

AWS::EC2::Instance.Ipv6Addresses

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-ipv6addresses

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or InstanceIpv6AddressProperty)[] (optional)
kernelId

AWS::EC2::Instance.KernelId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-kernelid

Type:string or @aws-cdk/cdk.Token (optional)
keyName

AWS::EC2::Instance.KeyName

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-keyname

Type:string or @aws-cdk/cdk.Token (optional)
launchTemplate

AWS::EC2::Instance.LaunchTemplate

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-launchtemplate

Type:@aws-cdk/cdk.Token or LaunchTemplateSpecificationProperty (optional)
licenseSpecifications

AWS::EC2::Instance.LicenseSpecifications

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-licensespecifications

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or LicenseSpecificationProperty)[] (optional)
monitoring

AWS::EC2::Instance.Monitoring

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-monitoring

Type:boolean or @aws-cdk/cdk.Token (optional)
networkInterfaces

AWS::EC2::Instance.NetworkInterfaces

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-networkinterfaces

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or NetworkInterfaceProperty)[] (optional)
placementGroupName

AWS::EC2::Instance.PlacementGroupName

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-placementgroupname

Type:string or @aws-cdk/cdk.Token (optional)
privateIpAddress

AWS::EC2::Instance.PrivateIpAddress

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-privateipaddress

Type:string or @aws-cdk/cdk.Token (optional)
ramdiskId

AWS::EC2::Instance.RamdiskId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-ramdiskid

Type:string or @aws-cdk/cdk.Token (optional)
securityGroupIds

AWS::EC2::Instance.SecurityGroupIds

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-securitygroupids

Type:@aws-cdk/cdk.Token or (string or @aws-cdk/cdk.Token)[] (optional)
securityGroups

AWS::EC2::Instance.SecurityGroups

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-securitygroups

Type:@aws-cdk/cdk.Token or (string or @aws-cdk/cdk.Token)[] (optional)
sourceDestCheck

AWS::EC2::Instance.SourceDestCheck

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-sourcedestcheck

Type:boolean or @aws-cdk/cdk.Token (optional)
ssmAssociations

AWS::EC2::Instance.SsmAssociations

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-ssmassociations

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or SsmAssociationProperty)[] (optional)
subnetId

AWS::EC2::Instance.SubnetId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-subnetid

Type:string or @aws-cdk/cdk.Token (optional)
tags

AWS::EC2::Instance.Tags

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-tags

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or @aws-cdk/cdk.Tag)[] (optional)
tenancy

AWS::EC2::Instance.Tenancy

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-tenancy

Type:string or @aws-cdk/cdk.Token (optional)
userData

AWS::EC2::Instance.UserData

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-userdata

Type:string or @aws-cdk/cdk.Token (optional)
volumes

AWS::EC2::Instance.Volumes

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html#cfn-ec2-instance-volumes

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or VolumeProperty)[] (optional)

InternetGatewayResource

class @aws-cdk/aws-ec2.cloudformation.InternetGatewayResource(parent, name[, properties])

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.InternetGatewayResource;
const { cloudformation.InternetGatewayResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.InternetGatewayResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this InternetGatewayResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (InternetGatewayResourceProps (optional)) – the properties of this InternetGatewayResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
internetGatewayName
Type:string (readonly)
propertyOverrides
Type:InternetGatewayResourceProps (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

InternetGatewayResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.InternetGatewayResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.InternetGatewayResourceProps;
// cloudformation.InternetGatewayResourceProps is an interface
import { cloudformation.InternetGatewayResourceProps } from '@aws-cdk/aws-ec2';
tags

AWS::EC2::InternetGateway.Tags

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-internetgateway.html#cfn-ec2-internetgateway-tags

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or @aws-cdk/cdk.Tag)[] (optional)

LaunchTemplateResource

class @aws-cdk/aws-ec2.cloudformation.LaunchTemplateResource(parent, name[, properties])

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.LaunchTemplateResource;
const { cloudformation.LaunchTemplateResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.LaunchTemplateResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this LaunchTemplateResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (LaunchTemplateResourceProps (optional)) – the properties of this LaunchTemplateResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
launchTemplateDefaultVersionNumber
Type:string (readonly)
launchTemplateId
Type:string (readonly)
launchTemplateLatestVersionNumber
Type:string (readonly)
propertyOverrides
Type:LaunchTemplateResourceProps (readonly)
class BlockDeviceMappingProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.LaunchTemplateResource.BlockDeviceMappingProperty;
// cloudformation.LaunchTemplateResource.BlockDeviceMappingProperty is an interface
import { cloudformation.LaunchTemplateResource.BlockDeviceMappingProperty } from '@aws-cdk/aws-ec2';
deviceName

LaunchTemplateResource.BlockDeviceMappingProperty.DeviceName

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-blockdevicemapping.html#cfn-ec2-launchtemplate-blockdevicemapping-devicename

Type:string or @aws-cdk/cdk.Token (optional)
ebs

LaunchTemplateResource.BlockDeviceMappingProperty.Ebs

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-blockdevicemapping.html#cfn-ec2-launchtemplate-blockdevicemapping-ebs

Type:@aws-cdk/cdk.Token or EbsProperty (optional)
noDevice

LaunchTemplateResource.BlockDeviceMappingProperty.NoDevice

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-blockdevicemapping.html#cfn-ec2-launchtemplate-blockdevicemapping-nodevice

Type:string or @aws-cdk/cdk.Token (optional)
virtualName

LaunchTemplateResource.BlockDeviceMappingProperty.VirtualName

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-blockdevicemapping.html#cfn-ec2-launchtemplate-blockdevicemapping-virtualname

Type:string or @aws-cdk/cdk.Token (optional)
class CreditSpecificationProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.LaunchTemplateResource.CreditSpecificationProperty;
// cloudformation.LaunchTemplateResource.CreditSpecificationProperty is an interface
import { cloudformation.LaunchTemplateResource.CreditSpecificationProperty } from '@aws-cdk/aws-ec2';
cpuCredits

LaunchTemplateResource.CreditSpecificationProperty.CpuCredits

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata-creditspecification.html#cfn-ec2-launchtemplate-launchtemplatedata-creditspecification-cpucredits

Type:string or @aws-cdk/cdk.Token (optional)
class EbsProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.LaunchTemplateResource.EbsProperty;
// cloudformation.LaunchTemplateResource.EbsProperty is an interface
import { cloudformation.LaunchTemplateResource.EbsProperty } from '@aws-cdk/aws-ec2';
deleteOnTermination

LaunchTemplateResource.EbsProperty.DeleteOnTermination

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-blockdevicemapping-ebs.html#cfn-ec2-launchtemplate-blockdevicemapping-ebs-deleteontermination

Type:boolean or @aws-cdk/cdk.Token (optional)
encrypted

LaunchTemplateResource.EbsProperty.Encrypted

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-blockdevicemapping-ebs.html#cfn-ec2-launchtemplate-blockdevicemapping-ebs-encrypted

Type:boolean or @aws-cdk/cdk.Token (optional)
iops

LaunchTemplateResource.EbsProperty.Iops

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-blockdevicemapping-ebs.html#cfn-ec2-launchtemplate-blockdevicemapping-ebs-iops

Type:number or @aws-cdk/cdk.Token (optional)
kmsKeyId

LaunchTemplateResource.EbsProperty.KmsKeyId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-blockdevicemapping-ebs.html#cfn-ec2-launchtemplate-blockdevicemapping-ebs-kmskeyid

Type:string or @aws-cdk/cdk.Token (optional)
snapshotId

LaunchTemplateResource.EbsProperty.SnapshotId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-blockdevicemapping-ebs.html#cfn-ec2-launchtemplate-blockdevicemapping-ebs-snapshotid

Type:string or @aws-cdk/cdk.Token (optional)
volumeSize

LaunchTemplateResource.EbsProperty.VolumeSize

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-blockdevicemapping-ebs.html#cfn-ec2-launchtemplate-blockdevicemapping-ebs-volumesize

Type:number or @aws-cdk/cdk.Token (optional)
volumeType

LaunchTemplateResource.EbsProperty.VolumeType

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-blockdevicemapping-ebs.html#cfn-ec2-launchtemplate-blockdevicemapping-ebs-volumetype

Type:string or @aws-cdk/cdk.Token (optional)
class ElasticGpuSpecificationProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.LaunchTemplateResource.ElasticGpuSpecificationProperty;
// cloudformation.LaunchTemplateResource.ElasticGpuSpecificationProperty is an interface
import { cloudformation.LaunchTemplateResource.ElasticGpuSpecificationProperty } from '@aws-cdk/aws-ec2';
type

LaunchTemplateResource.ElasticGpuSpecificationProperty.Type

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-elasticgpuspecification.html#cfn-ec2-launchtemplate-elasticgpuspecification-type

Type:string or @aws-cdk/cdk.Token (optional)
class IamInstanceProfileProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.LaunchTemplateResource.IamInstanceProfileProperty;
// cloudformation.LaunchTemplateResource.IamInstanceProfileProperty is an interface
import { cloudformation.LaunchTemplateResource.IamInstanceProfileProperty } from '@aws-cdk/aws-ec2';
arn

LaunchTemplateResource.IamInstanceProfileProperty.Arn

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata-iaminstanceprofile.html#cfn-ec2-launchtemplate-launchtemplatedata-iaminstanceprofile-arn

Type:string or @aws-cdk/cdk.Token (optional)
name

LaunchTemplateResource.IamInstanceProfileProperty.Name

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata-iaminstanceprofile.html#cfn-ec2-launchtemplate-launchtemplatedata-iaminstanceprofile-name

Type:string or @aws-cdk/cdk.Token (optional)
class InstanceMarketOptionsProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.LaunchTemplateResource.InstanceMarketOptionsProperty;
// cloudformation.LaunchTemplateResource.InstanceMarketOptionsProperty is an interface
import { cloudformation.LaunchTemplateResource.InstanceMarketOptionsProperty } from '@aws-cdk/aws-ec2';
marketType

LaunchTemplateResource.InstanceMarketOptionsProperty.MarketType

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata-instancemarketoptions.html#cfn-ec2-launchtemplate-launchtemplatedata-instancemarketoptions-markettype

Type:string or @aws-cdk/cdk.Token (optional)
spotOptions

LaunchTemplateResource.InstanceMarketOptionsProperty.SpotOptions

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata-instancemarketoptions.html#cfn-ec2-launchtemplate-launchtemplatedata-instancemarketoptions-spotoptions

Type:@aws-cdk/cdk.Token or SpotOptionsProperty (optional)
class Ipv6AddProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.LaunchTemplateResource.Ipv6AddProperty;
// cloudformation.LaunchTemplateResource.Ipv6AddProperty is an interface
import { cloudformation.LaunchTemplateResource.Ipv6AddProperty } from '@aws-cdk/aws-ec2';
ipv6Address

LaunchTemplateResource.Ipv6AddProperty.Ipv6Address

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-ipv6add.html#cfn-ec2-launchtemplate-ipv6add-ipv6address

Type:string or @aws-cdk/cdk.Token (optional)
class LaunchTemplateDataProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.LaunchTemplateResource.LaunchTemplateDataProperty;
// cloudformation.LaunchTemplateResource.LaunchTemplateDataProperty is an interface
import { cloudformation.LaunchTemplateResource.LaunchTemplateDataProperty } from '@aws-cdk/aws-ec2';
blockDeviceMappings

LaunchTemplateResource.LaunchTemplateDataProperty.BlockDeviceMappings

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-blockdevicemappings

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or BlockDeviceMappingProperty)[] (optional)
creditSpecification

LaunchTemplateResource.LaunchTemplateDataProperty.CreditSpecification

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-creditspecification

Type:@aws-cdk/cdk.Token or CreditSpecificationProperty (optional)
disableApiTermination

LaunchTemplateResource.LaunchTemplateDataProperty.DisableApiTermination

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-disableapitermination

Type:boolean or @aws-cdk/cdk.Token (optional)
ebsOptimized

LaunchTemplateResource.LaunchTemplateDataProperty.EbsOptimized

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-ebsoptimized

Type:boolean or @aws-cdk/cdk.Token (optional)
elasticGpuSpecifications

LaunchTemplateResource.LaunchTemplateDataProperty.ElasticGpuSpecifications

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-elasticgpuspecifications

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or ElasticGpuSpecificationProperty)[] (optional)
iamInstanceProfile

LaunchTemplateResource.LaunchTemplateDataProperty.IamInstanceProfile

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-iaminstanceprofile

Type:@aws-cdk/cdk.Token or IamInstanceProfileProperty (optional)
imageId

LaunchTemplateResource.LaunchTemplateDataProperty.ImageId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-imageid

Type:string or @aws-cdk/cdk.Token (optional)
instanceInitiatedShutdownBehavior

LaunchTemplateResource.LaunchTemplateDataProperty.InstanceInitiatedShutdownBehavior

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-instanceinitiatedshutdownbehavior

Type:string or @aws-cdk/cdk.Token (optional)
instanceMarketOptions

LaunchTemplateResource.LaunchTemplateDataProperty.InstanceMarketOptions

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-instancemarketoptions

Type:@aws-cdk/cdk.Token or InstanceMarketOptionsProperty (optional)
instanceType

LaunchTemplateResource.LaunchTemplateDataProperty.InstanceType

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-instancetype

Type:string or @aws-cdk/cdk.Token (optional)
kernelId

LaunchTemplateResource.LaunchTemplateDataProperty.KernelId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-kernelid

Type:string or @aws-cdk/cdk.Token (optional)
keyName

LaunchTemplateResource.LaunchTemplateDataProperty.KeyName

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-keyname

Type:string or @aws-cdk/cdk.Token (optional)
monitoring

LaunchTemplateResource.LaunchTemplateDataProperty.Monitoring

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-monitoring

Type:@aws-cdk/cdk.Token or MonitoringProperty (optional)
networkInterfaces

LaunchTemplateResource.LaunchTemplateDataProperty.NetworkInterfaces

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-networkinterfaces

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or NetworkInterfaceProperty)[] (optional)
placement

LaunchTemplateResource.LaunchTemplateDataProperty.Placement

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-placement

Type:@aws-cdk/cdk.Token or PlacementProperty (optional)
ramDiskId

LaunchTemplateResource.LaunchTemplateDataProperty.RamDiskId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-ramdiskid

Type:string or @aws-cdk/cdk.Token (optional)
securityGroupIds

LaunchTemplateResource.LaunchTemplateDataProperty.SecurityGroupIds

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-securitygroupids

Type:@aws-cdk/cdk.Token or (string or @aws-cdk/cdk.Token)[] (optional)
securityGroups

LaunchTemplateResource.LaunchTemplateDataProperty.SecurityGroups

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-securitygroups

Type:@aws-cdk/cdk.Token or (string or @aws-cdk/cdk.Token)[] (optional)
tagSpecifications

LaunchTemplateResource.LaunchTemplateDataProperty.TagSpecifications

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-tagspecifications

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or TagSpecificationProperty)[] (optional)
userData

LaunchTemplateResource.LaunchTemplateDataProperty.UserData

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-userdata

Type:string or @aws-cdk/cdk.Token (optional)
class MonitoringProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.LaunchTemplateResource.MonitoringProperty;
// cloudformation.LaunchTemplateResource.MonitoringProperty is an interface
import { cloudformation.LaunchTemplateResource.MonitoringProperty } from '@aws-cdk/aws-ec2';
enabled

LaunchTemplateResource.MonitoringProperty.Enabled

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata-monitoring.html#cfn-ec2-launchtemplate-launchtemplatedata-monitoring-enabled

Type:boolean or @aws-cdk/cdk.Token (optional)
class NetworkInterfaceProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.LaunchTemplateResource.NetworkInterfaceProperty;
// cloudformation.LaunchTemplateResource.NetworkInterfaceProperty is an interface
import { cloudformation.LaunchTemplateResource.NetworkInterfaceProperty } from '@aws-cdk/aws-ec2';
associatePublicIpAddress

LaunchTemplateResource.NetworkInterfaceProperty.AssociatePublicIpAddress

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-networkinterface.html#cfn-ec2-launchtemplate-networkinterface-associatepublicipaddress

Type:boolean or @aws-cdk/cdk.Token (optional)
deleteOnTermination

LaunchTemplateResource.NetworkInterfaceProperty.DeleteOnTermination

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-networkinterface.html#cfn-ec2-launchtemplate-networkinterface-deleteontermination

Type:boolean or @aws-cdk/cdk.Token (optional)
description

LaunchTemplateResource.NetworkInterfaceProperty.Description

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-networkinterface.html#cfn-ec2-launchtemplate-networkinterface-description

Type:string or @aws-cdk/cdk.Token (optional)
deviceIndex

LaunchTemplateResource.NetworkInterfaceProperty.DeviceIndex

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-networkinterface.html#cfn-ec2-launchtemplate-networkinterface-deviceindex

Type:number or @aws-cdk/cdk.Token (optional)
groups

LaunchTemplateResource.NetworkInterfaceProperty.Groups

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-networkinterface.html#cfn-ec2-launchtemplate-networkinterface-groups

Type:@aws-cdk/cdk.Token or (string or @aws-cdk/cdk.Token)[] (optional)
ipv6AddressCount

LaunchTemplateResource.NetworkInterfaceProperty.Ipv6AddressCount

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-networkinterface.html#cfn-ec2-launchtemplate-networkinterface-ipv6addresscount

Type:number or @aws-cdk/cdk.Token (optional)
ipv6Addresses

LaunchTemplateResource.NetworkInterfaceProperty.Ipv6Addresses

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-networkinterface.html#cfn-ec2-launchtemplate-networkinterface-ipv6addresses

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or Ipv6AddProperty)[] (optional)
networkInterfaceId

LaunchTemplateResource.NetworkInterfaceProperty.NetworkInterfaceId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-networkinterface.html#cfn-ec2-launchtemplate-networkinterface-networkinterfaceid

Type:string or @aws-cdk/cdk.Token (optional)
privateIpAddress

LaunchTemplateResource.NetworkInterfaceProperty.PrivateIpAddress

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-networkinterface.html#cfn-ec2-launchtemplate-networkinterface-privateipaddress

Type:string or @aws-cdk/cdk.Token (optional)
privateIpAddresses

LaunchTemplateResource.NetworkInterfaceProperty.PrivateIpAddresses

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-networkinterface.html#cfn-ec2-launchtemplate-networkinterface-privateipaddresses

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or PrivateIpAddProperty)[] (optional)
secondaryPrivateIpAddressCount

LaunchTemplateResource.NetworkInterfaceProperty.SecondaryPrivateIpAddressCount

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-networkinterface.html#cfn-ec2-launchtemplate-networkinterface-secondaryprivateipaddresscount

Type:number or @aws-cdk/cdk.Token (optional)
subnetId

LaunchTemplateResource.NetworkInterfaceProperty.SubnetId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-networkinterface.html#cfn-ec2-launchtemplate-networkinterface-subnetid

Type:string or @aws-cdk/cdk.Token (optional)
class PlacementProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.LaunchTemplateResource.PlacementProperty;
// cloudformation.LaunchTemplateResource.PlacementProperty is an interface
import { cloudformation.LaunchTemplateResource.PlacementProperty } from '@aws-cdk/aws-ec2';
affinity

LaunchTemplateResource.PlacementProperty.Affinity

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata-placement.html#cfn-ec2-launchtemplate-launchtemplatedata-placement-affinity

Type:string or @aws-cdk/cdk.Token (optional)
availabilityZone

LaunchTemplateResource.PlacementProperty.AvailabilityZone

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata-placement.html#cfn-ec2-launchtemplate-launchtemplatedata-placement-availabilityzone

Type:string or @aws-cdk/cdk.Token (optional)
groupName

LaunchTemplateResource.PlacementProperty.GroupName

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata-placement.html#cfn-ec2-launchtemplate-launchtemplatedata-placement-groupname

Type:string or @aws-cdk/cdk.Token (optional)
hostId

LaunchTemplateResource.PlacementProperty.HostId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata-placement.html#cfn-ec2-launchtemplate-launchtemplatedata-placement-hostid

Type:string or @aws-cdk/cdk.Token (optional)
tenancy

LaunchTemplateResource.PlacementProperty.Tenancy

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata-placement.html#cfn-ec2-launchtemplate-launchtemplatedata-placement-tenancy

Type:string or @aws-cdk/cdk.Token (optional)
class PrivateIpAddProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.LaunchTemplateResource.PrivateIpAddProperty;
// cloudformation.LaunchTemplateResource.PrivateIpAddProperty is an interface
import { cloudformation.LaunchTemplateResource.PrivateIpAddProperty } from '@aws-cdk/aws-ec2';
primary

LaunchTemplateResource.PrivateIpAddProperty.Primary

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-privateipadd.html#cfn-ec2-launchtemplate-privateipadd-primary

Type:boolean or @aws-cdk/cdk.Token (optional)
privateIpAddress

LaunchTemplateResource.PrivateIpAddProperty.PrivateIpAddress

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-privateipadd.html#cfn-ec2-launchtemplate-privateipadd-privateipaddress

Type:string or @aws-cdk/cdk.Token (optional)
class SpotOptionsProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.LaunchTemplateResource.SpotOptionsProperty;
// cloudformation.LaunchTemplateResource.SpotOptionsProperty is an interface
import { cloudformation.LaunchTemplateResource.SpotOptionsProperty } from '@aws-cdk/aws-ec2';
instanceInterruptionBehavior

LaunchTemplateResource.SpotOptionsProperty.InstanceInterruptionBehavior

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata-instancemarketoptions-spotoptions.html#cfn-ec2-launchtemplate-launchtemplatedata-instancemarketoptions-spotoptions-instanceinterruptionbehavior

Type:string or @aws-cdk/cdk.Token (optional)
maxPrice

LaunchTemplateResource.SpotOptionsProperty.MaxPrice

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata-instancemarketoptions-spotoptions.html#cfn-ec2-launchtemplate-launchtemplatedata-instancemarketoptions-spotoptions-maxprice

Type:string or @aws-cdk/cdk.Token (optional)
spotInstanceType

LaunchTemplateResource.SpotOptionsProperty.SpotInstanceType

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata-instancemarketoptions-spotoptions.html#cfn-ec2-launchtemplate-launchtemplatedata-instancemarketoptions-spotoptions-spotinstancetype

Type:string or @aws-cdk/cdk.Token (optional)
class TagSpecificationProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.LaunchTemplateResource.TagSpecificationProperty;
// cloudformation.LaunchTemplateResource.TagSpecificationProperty is an interface
import { cloudformation.LaunchTemplateResource.TagSpecificationProperty } from '@aws-cdk/aws-ec2';
resourceType

LaunchTemplateResource.TagSpecificationProperty.ResourceType

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-tagspecification.html#cfn-ec2-launchtemplate-tagspecification-resourcetype

Type:string or @aws-cdk/cdk.Token (optional)
tags

LaunchTemplateResource.TagSpecificationProperty.Tags

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-tagspecification.html#cfn-ec2-launchtemplate-tagspecification-tags

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or @aws-cdk/cdk.Tag)[] (optional)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

LaunchTemplateResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.LaunchTemplateResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.LaunchTemplateResourceProps;
// cloudformation.LaunchTemplateResourceProps is an interface
import { cloudformation.LaunchTemplateResourceProps } from '@aws-cdk/aws-ec2';
launchTemplateData

AWS::EC2::LaunchTemplate.LaunchTemplateData

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-launchtemplate.html#cfn-ec2-launchtemplate-launchtemplatedata

Type:@aws-cdk/cdk.Token or LaunchTemplateDataProperty (optional)
launchTemplateName

AWS::EC2::LaunchTemplate.LaunchTemplateName

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-launchtemplate.html#cfn-ec2-launchtemplate-launchtemplatename

Type:string or @aws-cdk/cdk.Token (optional)

NatGatewayResource

class @aws-cdk/aws-ec2.cloudformation.NatGatewayResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.NatGatewayResource;
const { cloudformation.NatGatewayResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.NatGatewayResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this NatGatewayResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (NatGatewayResourceProps) – the properties of this NatGatewayResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
natGatewayId
Type:string (readonly)
propertyOverrides
Type:NatGatewayResourceProps (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

NatGatewayResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.NatGatewayResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.NatGatewayResourceProps;
// cloudformation.NatGatewayResourceProps is an interface
import { cloudformation.NatGatewayResourceProps } from '@aws-cdk/aws-ec2';
allocationId

AWS::EC2::NatGateway.AllocationId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-natgateway.html#cfn-ec2-natgateway-allocationid

Type:string or @aws-cdk/cdk.Token
subnetId

AWS::EC2::NatGateway.SubnetId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-natgateway.html#cfn-ec2-natgateway-subnetid

Type:string or @aws-cdk/cdk.Token
tags

AWS::EC2::NatGateway.Tags

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-natgateway.html#cfn-ec2-natgateway-tags

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or @aws-cdk/cdk.Tag)[] (optional)

NetworkAclEntryResource

class @aws-cdk/aws-ec2.cloudformation.NetworkAclEntryResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.NetworkAclEntryResource;
const { cloudformation.NetworkAclEntryResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.NetworkAclEntryResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this NetworkAclEntryResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (NetworkAclEntryResourceProps) – the properties of this NetworkAclEntryResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
networkAclEntryName
Type:string (readonly)
propertyOverrides
Type:NetworkAclEntryResourceProps (readonly)
class IcmpProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.NetworkAclEntryResource.IcmpProperty;
// cloudformation.NetworkAclEntryResource.IcmpProperty is an interface
import { cloudformation.NetworkAclEntryResource.IcmpProperty } from '@aws-cdk/aws-ec2';
code

NetworkAclEntryResource.IcmpProperty.Code

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-networkaclentry-icmp.html#cfn-ec2-networkaclentry-icmp-code

Type:number or @aws-cdk/cdk.Token (optional)
type

NetworkAclEntryResource.IcmpProperty.Type

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-networkaclentry-icmp.html#cfn-ec2-networkaclentry-icmp-type

Type:number or @aws-cdk/cdk.Token (optional)
class PortRangeProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.NetworkAclEntryResource.PortRangeProperty;
// cloudformation.NetworkAclEntryResource.PortRangeProperty is an interface
import { cloudformation.NetworkAclEntryResource.PortRangeProperty } from '@aws-cdk/aws-ec2';
from

NetworkAclEntryResource.PortRangeProperty.From

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-networkaclentry-portrange.html#cfn-ec2-networkaclentry-portrange-from

Type:number or @aws-cdk/cdk.Token (optional)
to

NetworkAclEntryResource.PortRangeProperty.To

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-networkaclentry-portrange.html#cfn-ec2-networkaclentry-portrange-to

Type:number or @aws-cdk/cdk.Token (optional)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

NetworkAclEntryResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.NetworkAclEntryResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.NetworkAclEntryResourceProps;
// cloudformation.NetworkAclEntryResourceProps is an interface
import { cloudformation.NetworkAclEntryResourceProps } from '@aws-cdk/aws-ec2';
cidrBlock

AWS::EC2::NetworkAclEntry.CidrBlock

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-acl-entry.html#cfn-ec2-networkaclentry-cidrblock

Type:string or @aws-cdk/cdk.Token
networkAclId

AWS::EC2::NetworkAclEntry.NetworkAclId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-acl-entry.html#cfn-ec2-networkaclentry-networkaclid

Type:string or @aws-cdk/cdk.Token
protocol

AWS::EC2::NetworkAclEntry.Protocol

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-acl-entry.html#cfn-ec2-networkaclentry-protocol

Type:number or @aws-cdk/cdk.Token
ruleAction

AWS::EC2::NetworkAclEntry.RuleAction

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-acl-entry.html#cfn-ec2-networkaclentry-ruleaction

Type:string or @aws-cdk/cdk.Token
ruleNumber

AWS::EC2::NetworkAclEntry.RuleNumber

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-acl-entry.html#cfn-ec2-networkaclentry-rulenumber

Type:number or @aws-cdk/cdk.Token
egress

AWS::EC2::NetworkAclEntry.Egress

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-acl-entry.html#cfn-ec2-networkaclentry-egress

Type:boolean or @aws-cdk/cdk.Token (optional)
icmp

AWS::EC2::NetworkAclEntry.Icmp

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-acl-entry.html#cfn-ec2-networkaclentry-icmp

Type:@aws-cdk/cdk.Token or IcmpProperty (optional)
ipv6CidrBlock

AWS::EC2::NetworkAclEntry.Ipv6CidrBlock

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-acl-entry.html#cfn-ec2-networkaclentry-ipv6cidrblock

Type:string or @aws-cdk/cdk.Token (optional)
portRange

AWS::EC2::NetworkAclEntry.PortRange

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-acl-entry.html#cfn-ec2-networkaclentry-portrange

Type:@aws-cdk/cdk.Token or PortRangeProperty (optional)

NetworkAclResource

class @aws-cdk/aws-ec2.cloudformation.NetworkAclResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.NetworkAclResource;
const { cloudformation.NetworkAclResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.NetworkAclResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this NetworkAclResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (NetworkAclResourceProps) – the properties of this NetworkAclResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
networkAclName
Type:string (readonly)
propertyOverrides
Type:NetworkAclResourceProps (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

NetworkAclResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.NetworkAclResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.NetworkAclResourceProps;
// cloudformation.NetworkAclResourceProps is an interface
import { cloudformation.NetworkAclResourceProps } from '@aws-cdk/aws-ec2';
vpcId

AWS::EC2::NetworkAcl.VpcId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-acl.html#cfn-ec2-networkacl-vpcid

Type:string or @aws-cdk/cdk.Token
tags

AWS::EC2::NetworkAcl.Tags

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-acl.html#cfn-ec2-networkacl-tags

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or @aws-cdk/cdk.Tag)[] (optional)

NetworkInterfaceAttachmentResource

class @aws-cdk/aws-ec2.cloudformation.NetworkInterfaceAttachmentResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.NetworkInterfaceAttachmentResource;
const { cloudformation.NetworkInterfaceAttachmentResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.NetworkInterfaceAttachmentResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
networkInterfaceAttachmentName
Type:string (readonly)
propertyOverrides
Type:NetworkInterfaceAttachmentResourceProps (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

NetworkInterfaceAttachmentResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.NetworkInterfaceAttachmentResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.NetworkInterfaceAttachmentResourceProps;
// cloudformation.NetworkInterfaceAttachmentResourceProps is an interface
import { cloudformation.NetworkInterfaceAttachmentResourceProps } from '@aws-cdk/aws-ec2';
deviceIndex

AWS::EC2::NetworkInterfaceAttachment.DeviceIndex

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-interface-attachment.html#cfn-ec2-network-interface-attachment-deviceindex

Type:string or @aws-cdk/cdk.Token
instanceId

AWS::EC2::NetworkInterfaceAttachment.InstanceId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-interface-attachment.html#cfn-ec2-network-interface-attachment-instanceid

Type:string or @aws-cdk/cdk.Token
networkInterfaceId

AWS::EC2::NetworkInterfaceAttachment.NetworkInterfaceId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-interface-attachment.html#cfn-ec2-network-interface-attachment-networkinterfaceid

Type:string or @aws-cdk/cdk.Token
deleteOnTermination

AWS::EC2::NetworkInterfaceAttachment.DeleteOnTermination

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-interface-attachment.html#cfn-ec2-network-interface-attachment-deleteonterm

Type:boolean or @aws-cdk/cdk.Token (optional)

NetworkInterfacePermissionResource

class @aws-cdk/aws-ec2.cloudformation.NetworkInterfacePermissionResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.NetworkInterfacePermissionResource;
const { cloudformation.NetworkInterfacePermissionResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.NetworkInterfacePermissionResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
networkInterfacePermissionId
Type:string (readonly)
propertyOverrides
Type:NetworkInterfacePermissionResourceProps (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

NetworkInterfacePermissionResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.NetworkInterfacePermissionResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.NetworkInterfacePermissionResourceProps;
// cloudformation.NetworkInterfacePermissionResourceProps is an interface
import { cloudformation.NetworkInterfacePermissionResourceProps } from '@aws-cdk/aws-ec2';
awsAccountId

AWS::EC2::NetworkInterfacePermission.AwsAccountId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-networkinterfacepermission.html#cfn-ec2-networkinterfacepermission-awsaccountid

Type:string or @aws-cdk/cdk.Token
networkInterfaceId

AWS::EC2::NetworkInterfacePermission.NetworkInterfaceId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-networkinterfacepermission.html#cfn-ec2-networkinterfacepermission-networkinterfaceid

Type:string or @aws-cdk/cdk.Token
permission

AWS::EC2::NetworkInterfacePermission.Permission

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-networkinterfacepermission.html#cfn-ec2-networkinterfacepermission-permission

Type:string or @aws-cdk/cdk.Token

NetworkInterfaceResource

class @aws-cdk/aws-ec2.cloudformation.NetworkInterfaceResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.NetworkInterfaceResource;
const { cloudformation.NetworkInterfaceResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.NetworkInterfaceResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this NetworkInterfaceResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (NetworkInterfaceResourceProps) – the properties of this NetworkInterfaceResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
networkInterfaceName
Type:string (readonly)
networkInterfacePrimaryPrivateIpAddress
Type:string (readonly)
networkInterfaceSecondaryPrivateIpAddresses
Type:NetworkInterfaceSecondaryPrivateIpAddresses (readonly)
propertyOverrides
Type:NetworkInterfaceResourceProps (readonly)
class InstanceIpv6AddressProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.NetworkInterfaceResource.InstanceIpv6AddressProperty;
// cloudformation.NetworkInterfaceResource.InstanceIpv6AddressProperty is an interface
import { cloudformation.NetworkInterfaceResource.InstanceIpv6AddressProperty } from '@aws-cdk/aws-ec2';
ipv6Address

NetworkInterfaceResource.InstanceIpv6AddressProperty.Ipv6Address

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-networkinterface-instanceipv6address.html#cfn-ec2-networkinterface-instanceipv6address-ipv6address

Type:string or @aws-cdk/cdk.Token
class PrivateIpAddressSpecificationProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.NetworkInterfaceResource.PrivateIpAddressSpecificationProperty;
// cloudformation.NetworkInterfaceResource.PrivateIpAddressSpecificationProperty is an interface
import { cloudformation.NetworkInterfaceResource.PrivateIpAddressSpecificationProperty } from '@aws-cdk/aws-ec2';
primary

NetworkInterfaceResource.PrivateIpAddressSpecificationProperty.Primary

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-network-interface-privateipspec.html#cfn-ec2-networkinterface-privateipspecification-primary

Type:boolean or @aws-cdk/cdk.Token
privateIpAddress

NetworkInterfaceResource.PrivateIpAddressSpecificationProperty.PrivateIpAddress

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-network-interface-privateipspec.html#cfn-ec2-networkinterface-privateipspecification-privateipaddress

Type:string or @aws-cdk/cdk.Token
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

NetworkInterfaceResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.NetworkInterfaceResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.NetworkInterfaceResourceProps;
// cloudformation.NetworkInterfaceResourceProps is an interface
import { cloudformation.NetworkInterfaceResourceProps } from '@aws-cdk/aws-ec2';
subnetId

AWS::EC2::NetworkInterface.SubnetId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-interface.html#cfn-awsec2networkinterface-subnetid

Type:string or @aws-cdk/cdk.Token
description

AWS::EC2::NetworkInterface.Description

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-interface.html#cfn-awsec2networkinterface-description

Type:string or @aws-cdk/cdk.Token (optional)
groupSet

AWS::EC2::NetworkInterface.GroupSet

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-interface.html#cfn-awsec2networkinterface-groupset

Type:@aws-cdk/cdk.Token or (string or @aws-cdk/cdk.Token)[] (optional)
interfaceType

AWS::EC2::NetworkInterface.InterfaceType

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-interface.html#cfn-ec2-networkinterface-interfacetype

Type:string or @aws-cdk/cdk.Token (optional)
ipv6AddressCount

AWS::EC2::NetworkInterface.Ipv6AddressCount

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-interface.html#cfn-ec2-networkinterface-ipv6addresscount

Type:number or @aws-cdk/cdk.Token (optional)
ipv6Addresses

AWS::EC2::NetworkInterface.Ipv6Addresses

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-interface.html#cfn-ec2-networkinterface-ipv6addresses

Type:@aws-cdk/cdk.Token or InstanceIpv6AddressProperty (optional)
privateIpAddress

AWS::EC2::NetworkInterface.PrivateIpAddress

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-interface.html#cfn-awsec2networkinterface-privateipaddress

Type:string or @aws-cdk/cdk.Token (optional)
privateIpAddresses

AWS::EC2::NetworkInterface.PrivateIpAddresses

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-interface.html#cfn-awsec2networkinterface-privateipaddresses

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or PrivateIpAddressSpecificationProperty)[] (optional)
secondaryPrivateIpAddressCount

AWS::EC2::NetworkInterface.SecondaryPrivateIpAddressCount

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-interface.html#cfn-awsec2networkinterface-secondaryprivateipcount

Type:number or @aws-cdk/cdk.Token (optional)
sourceDestCheck

AWS::EC2::NetworkInterface.SourceDestCheck

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-interface.html#cfn-awsec2networkinterface-sourcedestcheck

Type:boolean or @aws-cdk/cdk.Token (optional)
tags

AWS::EC2::NetworkInterface.Tags

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-network-interface.html#cfn-awsec2networkinterface-tags

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or @aws-cdk/cdk.Tag)[] (optional)

PlacementGroupResource

class @aws-cdk/aws-ec2.cloudformation.PlacementGroupResource(parent, name[, properties])

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.PlacementGroupResource;
const { cloudformation.PlacementGroupResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.PlacementGroupResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this PlacementGroupResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (PlacementGroupResourceProps (optional)) – the properties of this PlacementGroupResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
placementGroupName
Type:string (readonly)
propertyOverrides
Type:PlacementGroupResourceProps (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

PlacementGroupResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.PlacementGroupResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.PlacementGroupResourceProps;
// cloudformation.PlacementGroupResourceProps is an interface
import { cloudformation.PlacementGroupResourceProps } from '@aws-cdk/aws-ec2';
strategy

AWS::EC2::PlacementGroup.Strategy

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-placementgroup.html#cfn-ec2-placementgroup-strategy

Type:string or @aws-cdk/cdk.Token (optional)

RouteResource

class @aws-cdk/aws-ec2.cloudformation.RouteResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.RouteResource;
const { cloudformation.RouteResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.RouteResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this RouteResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (RouteResourceProps) – the properties of this RouteResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:RouteResourceProps (readonly)
routeName
Type:string (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

RouteResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.RouteResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.RouteResourceProps;
// cloudformation.RouteResourceProps is an interface
import { cloudformation.RouteResourceProps } from '@aws-cdk/aws-ec2';
routeTableId

AWS::EC2::Route.RouteTableId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-route.html#cfn-ec2-route-routetableid

Type:string or @aws-cdk/cdk.Token
destinationCidrBlock

AWS::EC2::Route.DestinationCidrBlock

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-route.html#cfn-ec2-route-destinationcidrblock

Type:string or @aws-cdk/cdk.Token (optional)
destinationIpv6CidrBlock

AWS::EC2::Route.DestinationIpv6CidrBlock

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-route.html#cfn-ec2-route-destinationipv6cidrblock

Type:string or @aws-cdk/cdk.Token (optional)
egressOnlyInternetGatewayId

AWS::EC2::Route.EgressOnlyInternetGatewayId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-route.html#cfn-ec2-route-egressonlyinternetgatewayid

Type:string or @aws-cdk/cdk.Token (optional)
gatewayId

AWS::EC2::Route.GatewayId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-route.html#cfn-ec2-route-gatewayid

Type:string or @aws-cdk/cdk.Token (optional)
instanceId

AWS::EC2::Route.InstanceId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-route.html#cfn-ec2-route-instanceid

Type:string or @aws-cdk/cdk.Token (optional)
natGatewayId

AWS::EC2::Route.NatGatewayId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-route.html#cfn-ec2-route-natgatewayid

Type:string or @aws-cdk/cdk.Token (optional)
networkInterfaceId

AWS::EC2::Route.NetworkInterfaceId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-route.html#cfn-ec2-route-networkinterfaceid

Type:string or @aws-cdk/cdk.Token (optional)
vpcPeeringConnectionId

AWS::EC2::Route.VpcPeeringConnectionId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-route.html#cfn-ec2-route-vpcpeeringconnectionid

Type:string or @aws-cdk/cdk.Token (optional)

RouteTableResource

class @aws-cdk/aws-ec2.cloudformation.RouteTableResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.RouteTableResource;
const { cloudformation.RouteTableResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.RouteTableResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this RouteTableResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (RouteTableResourceProps) – the properties of this RouteTableResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:RouteTableResourceProps (readonly)
routeTableId
Type:string (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

RouteTableResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.RouteTableResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.RouteTableResourceProps;
// cloudformation.RouteTableResourceProps is an interface
import { cloudformation.RouteTableResourceProps } from '@aws-cdk/aws-ec2';
vpcId

AWS::EC2::RouteTable.VpcId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-route-table.html#cfn-ec2-routetable-vpcid

Type:string or @aws-cdk/cdk.Token
tags

AWS::EC2::RouteTable.Tags

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-route-table.html#cfn-ec2-routetable-tags

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or @aws-cdk/cdk.Tag)[] (optional)

SecurityGroupEgressResource

class @aws-cdk/aws-ec2.cloudformation.SecurityGroupEgressResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SecurityGroupEgressResource;
const { cloudformation.SecurityGroupEgressResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.SecurityGroupEgressResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this SecurityGroupEgressResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (SecurityGroupEgressResourceProps) – the properties of this SecurityGroupEgressResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:SecurityGroupEgressResourceProps (readonly)
securityGroupEgressId
Type:string (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

SecurityGroupEgressResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.SecurityGroupEgressResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SecurityGroupEgressResourceProps;
// cloudformation.SecurityGroupEgressResourceProps is an interface
import { cloudformation.SecurityGroupEgressResourceProps } from '@aws-cdk/aws-ec2';
groupId

AWS::EC2::SecurityGroupEgress.GroupId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-security-group-egress.html#cfn-ec2-securitygroupegress-groupid

Type:string or @aws-cdk/cdk.Token
ipProtocol

AWS::EC2::SecurityGroupEgress.IpProtocol

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-security-group-egress.html#cfn-ec2-securitygroupegress-ipprotocol

Type:string or @aws-cdk/cdk.Token
cidrIp

AWS::EC2::SecurityGroupEgress.CidrIp

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-security-group-egress.html#cfn-ec2-securitygroupegress-cidrip

Type:string or @aws-cdk/cdk.Token (optional)
cidrIpv6

AWS::EC2::SecurityGroupEgress.CidrIpv6

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-security-group-egress.html#cfn-ec2-securitygroupegress-cidripv6

Type:string or @aws-cdk/cdk.Token (optional)
description

AWS::EC2::SecurityGroupEgress.Description

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-security-group-egress.html#cfn-ec2-securitygroupegress-description

Type:string or @aws-cdk/cdk.Token (optional)
destinationPrefixListId

AWS::EC2::SecurityGroupEgress.DestinationPrefixListId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-security-group-egress.html#cfn-ec2-securitygroupegress-destinationprefixlistid

Type:string or @aws-cdk/cdk.Token (optional)
destinationSecurityGroupId

AWS::EC2::SecurityGroupEgress.DestinationSecurityGroupId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-security-group-egress.html#cfn-ec2-securitygroupegress-destinationsecuritygroupid

Type:string or @aws-cdk/cdk.Token (optional)
fromPort

AWS::EC2::SecurityGroupEgress.FromPort

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-security-group-egress.html#cfn-ec2-securitygroupegress-fromport

Type:number or @aws-cdk/cdk.Token (optional)
toPort

AWS::EC2::SecurityGroupEgress.ToPort

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-security-group-egress.html#cfn-ec2-securitygroupegress-toport

Type:number or @aws-cdk/cdk.Token (optional)

SecurityGroupIngressResource

class @aws-cdk/aws-ec2.cloudformation.SecurityGroupIngressResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SecurityGroupIngressResource;
const { cloudformation.SecurityGroupIngressResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.SecurityGroupIngressResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:SecurityGroupIngressResourceProps (readonly)
securityGroupIngressId
Type:string (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

SecurityGroupIngressResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.SecurityGroupIngressResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SecurityGroupIngressResourceProps;
// cloudformation.SecurityGroupIngressResourceProps is an interface
import { cloudformation.SecurityGroupIngressResourceProps } from '@aws-cdk/aws-ec2';
ipProtocol

AWS::EC2::SecurityGroupIngress.IpProtocol

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-ingress.html#cfn-ec2-security-group-ingress-ipprotocol

Type:string or @aws-cdk/cdk.Token
cidrIp

AWS::EC2::SecurityGroupIngress.CidrIp

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-ingress.html#cfn-ec2-security-group-ingress-cidrip

Type:string or @aws-cdk/cdk.Token (optional)
cidrIpv6

AWS::EC2::SecurityGroupIngress.CidrIpv6

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-ingress.html#cfn-ec2-security-group-ingress-cidripv6

Type:string or @aws-cdk/cdk.Token (optional)
description

AWS::EC2::SecurityGroupIngress.Description

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-ingress.html#cfn-ec2-security-group-ingress-description

Type:string or @aws-cdk/cdk.Token (optional)
fromPort

AWS::EC2::SecurityGroupIngress.FromPort

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-ingress.html#cfn-ec2-security-group-ingress-fromport

Type:number or @aws-cdk/cdk.Token (optional)
groupId

AWS::EC2::SecurityGroupIngress.GroupId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-ingress.html#cfn-ec2-security-group-ingress-groupid

Type:string or @aws-cdk/cdk.Token (optional)
groupName

AWS::EC2::SecurityGroupIngress.GroupName

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-ingress.html#cfn-ec2-security-group-ingress-groupname

Type:string or @aws-cdk/cdk.Token (optional)
sourcePrefixListId

AWS::EC2::SecurityGroupIngress.SourcePrefixListId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-ingress.html#cfn-ec2-securitygroupingress-sourceprefixlistid

Type:string or @aws-cdk/cdk.Token (optional)
sourceSecurityGroupId

AWS::EC2::SecurityGroupIngress.SourceSecurityGroupId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-ingress.html#cfn-ec2-security-group-ingress-sourcesecuritygroupid

Type:string or @aws-cdk/cdk.Token (optional)
sourceSecurityGroupName

AWS::EC2::SecurityGroupIngress.SourceSecurityGroupName

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-ingress.html#cfn-ec2-security-group-ingress-sourcesecuritygroupname

Type:string or @aws-cdk/cdk.Token (optional)
sourceSecurityGroupOwnerId

AWS::EC2::SecurityGroupIngress.SourceSecurityGroupOwnerId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-ingress.html#cfn-ec2-security-group-ingress-sourcesecuritygroupownerid

Type:string or @aws-cdk/cdk.Token (optional)
toPort

AWS::EC2::SecurityGroupIngress.ToPort

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-ingress.html#cfn-ec2-security-group-ingress-toport

Type:number or @aws-cdk/cdk.Token (optional)

SecurityGroupResource

class @aws-cdk/aws-ec2.cloudformation.SecurityGroupResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SecurityGroupResource;
const { cloudformation.SecurityGroupResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.SecurityGroupResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this SecurityGroupResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (SecurityGroupResourceProps) – the properties of this SecurityGroupResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:SecurityGroupResourceProps (readonly)
securityGroupId
Type:string (readonly)
securityGroupName
Type:string (readonly)
securityGroupVpcId
Type:string (readonly)
class EgressProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SecurityGroupResource.EgressProperty;
// cloudformation.SecurityGroupResource.EgressProperty is an interface
import { cloudformation.SecurityGroupResource.EgressProperty } from '@aws-cdk/aws-ec2';
ipProtocol

SecurityGroupResource.EgressProperty.IpProtocol

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-rule.html#cfn-ec2-security-group-rule-ipprotocol

Type:string or @aws-cdk/cdk.Token
cidrIp

SecurityGroupResource.EgressProperty.CidrIp

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-rule.html#cfn-ec2-security-group-rule-cidrip

Type:string or @aws-cdk/cdk.Token (optional)
cidrIpv6

SecurityGroupResource.EgressProperty.CidrIpv6

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-rule.html#cfn-ec2-security-group-rule-cidripv6

Type:string or @aws-cdk/cdk.Token (optional)
description

SecurityGroupResource.EgressProperty.Description

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-rule.html#cfn-ec2-security-group-rule-description

Type:string or @aws-cdk/cdk.Token (optional)
destinationPrefixListId

SecurityGroupResource.EgressProperty.DestinationPrefixListId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-rule.html#cfn-ec2-security-group-rule-destinationprefixlistid

Type:string or @aws-cdk/cdk.Token (optional)
destinationSecurityGroupId

SecurityGroupResource.EgressProperty.DestinationSecurityGroupId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-rule.html#cfn-ec2-security-group-rule-destsecgroupid

Type:string or @aws-cdk/cdk.Token (optional)
fromPort

SecurityGroupResource.EgressProperty.FromPort

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-rule.html#cfn-ec2-security-group-rule-fromport

Type:number or @aws-cdk/cdk.Token (optional)
toPort

SecurityGroupResource.EgressProperty.ToPort

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-rule.html#cfn-ec2-security-group-rule-toport

Type:number or @aws-cdk/cdk.Token (optional)
class IngressProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SecurityGroupResource.IngressProperty;
// cloudformation.SecurityGroupResource.IngressProperty is an interface
import { cloudformation.SecurityGroupResource.IngressProperty } from '@aws-cdk/aws-ec2';
ipProtocol

SecurityGroupResource.IngressProperty.IpProtocol

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-rule.html#cfn-ec2-security-group-rule-ipprotocol

Type:string or @aws-cdk/cdk.Token
cidrIp

SecurityGroupResource.IngressProperty.CidrIp

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-rule.html#cfn-ec2-security-group-rule-cidrip

Type:string or @aws-cdk/cdk.Token (optional)
cidrIpv6

SecurityGroupResource.IngressProperty.CidrIpv6

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-rule.html#cfn-ec2-security-group-rule-cidripv6

Type:string or @aws-cdk/cdk.Token (optional)
description

SecurityGroupResource.IngressProperty.Description

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-rule.html#cfn-ec2-security-group-rule-description

Type:string or @aws-cdk/cdk.Token (optional)
fromPort

SecurityGroupResource.IngressProperty.FromPort

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-rule.html#cfn-ec2-security-group-rule-fromport

Type:number or @aws-cdk/cdk.Token (optional)
sourcePrefixListId

SecurityGroupResource.IngressProperty.SourcePrefixListId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-rule.html#cfn-ec2-securitygroup-ingress-sourceprefixlistid

Type:string or @aws-cdk/cdk.Token (optional)
sourceSecurityGroupId

SecurityGroupResource.IngressProperty.SourceSecurityGroupId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-rule.html#cfn-ec2-security-group-rule-sourcesecuritygroupid

Type:string or @aws-cdk/cdk.Token (optional)
sourceSecurityGroupName

SecurityGroupResource.IngressProperty.SourceSecurityGroupName

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-rule.html#cfn-ec2-security-group-rule-sourcesecuritygroupname

Type:string or @aws-cdk/cdk.Token (optional)
sourceSecurityGroupOwnerId

SecurityGroupResource.IngressProperty.SourceSecurityGroupOwnerId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-rule.html#cfn-ec2-security-group-rule-sourcesecuritygroupownerid

Type:string or @aws-cdk/cdk.Token (optional)
toPort

SecurityGroupResource.IngressProperty.ToPort

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group-rule.html#cfn-ec2-security-group-rule-toport

Type:number or @aws-cdk/cdk.Token (optional)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

SecurityGroupResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.SecurityGroupResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SecurityGroupResourceProps;
// cloudformation.SecurityGroupResourceProps is an interface
import { cloudformation.SecurityGroupResourceProps } from '@aws-cdk/aws-ec2';
groupDescription

AWS::EC2::SecurityGroup.GroupDescription

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group.html#cfn-ec2-securitygroup-groupdescription

Type:string or @aws-cdk/cdk.Token
groupName

AWS::EC2::SecurityGroup.GroupName

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group.html#cfn-ec2-securitygroup-groupname

Type:string or @aws-cdk/cdk.Token (optional)
securityGroupEgress

AWS::EC2::SecurityGroup.SecurityGroupEgress

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group.html#cfn-ec2-securitygroup-securitygroupegress

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or EgressProperty)[] (optional)
securityGroupIngress

AWS::EC2::SecurityGroup.SecurityGroupIngress

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group.html#cfn-ec2-securitygroup-securitygroupingress

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or IngressProperty)[] (optional)
tags

AWS::EC2::SecurityGroup.Tags

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group.html#cfn-ec2-securitygroup-tags

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or @aws-cdk/cdk.Tag)[] (optional)
vpcId

AWS::EC2::SecurityGroup.VpcId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group.html#cfn-ec2-securitygroup-vpcid

Type:string or @aws-cdk/cdk.Token (optional)

SpotFleetResource

class @aws-cdk/aws-ec2.cloudformation.SpotFleetResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SpotFleetResource;
const { cloudformation.SpotFleetResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.SpotFleetResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this SpotFleetResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (SpotFleetResourceProps) – the properties of this SpotFleetResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:SpotFleetResourceProps (readonly)
spotFleetName
Type:string (readonly)
class BlockDeviceMappingProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SpotFleetResource.BlockDeviceMappingProperty;
// cloudformation.SpotFleetResource.BlockDeviceMappingProperty is an interface
import { cloudformation.SpotFleetResource.BlockDeviceMappingProperty } from '@aws-cdk/aws-ec2';
deviceName

SpotFleetResource.BlockDeviceMappingProperty.DeviceName

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-blockdevicemappings.html#cfn-ec2-spotfleet-blockdevicemapping-devicename

Type:string or @aws-cdk/cdk.Token
ebs

SpotFleetResource.BlockDeviceMappingProperty.Ebs

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-blockdevicemappings.html#cfn-ec2-spotfleet-blockdevicemapping-ebs

Type:@aws-cdk/cdk.Token or EbsBlockDeviceProperty (optional)
noDevice

SpotFleetResource.BlockDeviceMappingProperty.NoDevice

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-blockdevicemappings.html#cfn-ec2-spotfleet-blockdevicemapping-nodevice

Type:string or @aws-cdk/cdk.Token (optional)
virtualName

SpotFleetResource.BlockDeviceMappingProperty.VirtualName

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-blockdevicemappings.html#cfn-ec2-spotfleet-blockdevicemapping-virtualname

Type:string or @aws-cdk/cdk.Token (optional)
class ClassicLoadBalancerProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SpotFleetResource.ClassicLoadBalancerProperty;
// cloudformation.SpotFleetResource.ClassicLoadBalancerProperty is an interface
import { cloudformation.SpotFleetResource.ClassicLoadBalancerProperty } from '@aws-cdk/aws-ec2';
name

SpotFleetResource.ClassicLoadBalancerProperty.Name

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-classicloadbalancer.html#cfn-ec2-spotfleet-classicloadbalancer-name

Type:string or @aws-cdk/cdk.Token
class ClassicLoadBalancersConfigProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SpotFleetResource.ClassicLoadBalancersConfigProperty;
// cloudformation.SpotFleetResource.ClassicLoadBalancersConfigProperty is an interface
import { cloudformation.SpotFleetResource.ClassicLoadBalancersConfigProperty } from '@aws-cdk/aws-ec2';
classicLoadBalancers

SpotFleetResource.ClassicLoadBalancersConfigProperty.ClassicLoadBalancers

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-classicloadbalancersconfig.html#cfn-ec2-spotfleet-classicloadbalancersconfig-classicloadbalancers

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or ClassicLoadBalancerProperty)[]
class EbsBlockDeviceProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SpotFleetResource.EbsBlockDeviceProperty;
// cloudformation.SpotFleetResource.EbsBlockDeviceProperty is an interface
import { cloudformation.SpotFleetResource.EbsBlockDeviceProperty } from '@aws-cdk/aws-ec2';
deleteOnTermination

SpotFleetResource.EbsBlockDeviceProperty.DeleteOnTermination

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-blockdevicemappings-ebs.html#cfn-ec2-spotfleet-ebsblockdevice-deleteontermination

Type:boolean or @aws-cdk/cdk.Token (optional)
encrypted

SpotFleetResource.EbsBlockDeviceProperty.Encrypted

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-blockdevicemappings-ebs.html#cfn-ec2-spotfleet-ebsblockdevice-encrypted

Type:boolean or @aws-cdk/cdk.Token (optional)
iops

SpotFleetResource.EbsBlockDeviceProperty.Iops

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-blockdevicemappings-ebs.html#cfn-ec2-spotfleet-ebsblockdevice-iops

Type:number or @aws-cdk/cdk.Token (optional)
snapshotId

SpotFleetResource.EbsBlockDeviceProperty.SnapshotId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-blockdevicemappings-ebs.html#cfn-ec2-spotfleet-ebsblockdevice-snapshotid

Type:string or @aws-cdk/cdk.Token (optional)
volumeSize

SpotFleetResource.EbsBlockDeviceProperty.VolumeSize

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-blockdevicemappings-ebs.html#cfn-ec2-spotfleet-ebsblockdevice-volumesize

Type:number or @aws-cdk/cdk.Token (optional)
volumeType

SpotFleetResource.EbsBlockDeviceProperty.VolumeType

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-blockdevicemappings-ebs.html#cfn-ec2-spotfleet-ebsblockdevice-volumetype

Type:string or @aws-cdk/cdk.Token (optional)
class FleetLaunchTemplateSpecificationProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SpotFleetResource.FleetLaunchTemplateSpecificationProperty;
// cloudformation.SpotFleetResource.FleetLaunchTemplateSpecificationProperty is an interface
import { cloudformation.SpotFleetResource.FleetLaunchTemplateSpecificationProperty } from '@aws-cdk/aws-ec2';
version

SpotFleetResource.FleetLaunchTemplateSpecificationProperty.Version

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-fleetlaunchtemplatespecification.html#cfn-ec2-spotfleet-fleetlaunchtemplatespecification-version

Type:string or @aws-cdk/cdk.Token
launchTemplateId

SpotFleetResource.FleetLaunchTemplateSpecificationProperty.LaunchTemplateId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-fleetlaunchtemplatespecification.html#cfn-ec2-spotfleet-fleetlaunchtemplatespecification-launchtemplateid

Type:string or @aws-cdk/cdk.Token (optional)
launchTemplateName

SpotFleetResource.FleetLaunchTemplateSpecificationProperty.LaunchTemplateName

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-fleetlaunchtemplatespecification.html#cfn-ec2-spotfleet-fleetlaunchtemplatespecification-launchtemplatename

Type:string or @aws-cdk/cdk.Token (optional)
class GroupIdentifierProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SpotFleetResource.GroupIdentifierProperty;
// cloudformation.SpotFleetResource.GroupIdentifierProperty is an interface
import { cloudformation.SpotFleetResource.GroupIdentifierProperty } from '@aws-cdk/aws-ec2';
groupId

SpotFleetResource.GroupIdentifierProperty.GroupId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-securitygroups.html#cfn-ec2-spotfleet-groupidentifier-groupid

Type:string or @aws-cdk/cdk.Token
class IamInstanceProfileSpecificationProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SpotFleetResource.IamInstanceProfileSpecificationProperty;
// cloudformation.SpotFleetResource.IamInstanceProfileSpecificationProperty is an interface
import { cloudformation.SpotFleetResource.IamInstanceProfileSpecificationProperty } from '@aws-cdk/aws-ec2';
arn

SpotFleetResource.IamInstanceProfileSpecificationProperty.Arn

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-iaminstanceprofile.html#cfn-ec2-spotfleet-iaminstanceprofilespecification-arn

Type:string or @aws-cdk/cdk.Token (optional)
class InstanceIpv6AddressProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SpotFleetResource.InstanceIpv6AddressProperty;
// cloudformation.SpotFleetResource.InstanceIpv6AddressProperty is an interface
import { cloudformation.SpotFleetResource.InstanceIpv6AddressProperty } from '@aws-cdk/aws-ec2';
ipv6Address

SpotFleetResource.InstanceIpv6AddressProperty.Ipv6Address

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-instanceipv6address.html#cfn-ec2-spotfleet-instanceipv6address-ipv6address

Type:string or @aws-cdk/cdk.Token
class InstanceNetworkInterfaceSpecificationProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SpotFleetResource.InstanceNetworkInterfaceSpecificationProperty;
// cloudformation.SpotFleetResource.InstanceNetworkInterfaceSpecificationProperty is an interface
import { cloudformation.SpotFleetResource.InstanceNetworkInterfaceSpecificationProperty } from '@aws-cdk/aws-ec2';
associatePublicIpAddress

SpotFleetResource.InstanceNetworkInterfaceSpecificationProperty.AssociatePublicIpAddress

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-networkinterfaces.html#cfn-ec2-spotfleet-instancenetworkinterfacespecification-associatepublicipaddress

Type:boolean or @aws-cdk/cdk.Token (optional)
deleteOnTermination

SpotFleetResource.InstanceNetworkInterfaceSpecificationProperty.DeleteOnTermination

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-networkinterfaces.html#cfn-ec2-spotfleet-instancenetworkinterfacespecification-deleteontermination

Type:boolean or @aws-cdk/cdk.Token (optional)
description

SpotFleetResource.InstanceNetworkInterfaceSpecificationProperty.Description

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-networkinterfaces.html#cfn-ec2-spotfleet-instancenetworkinterfacespecification-description

Type:string or @aws-cdk/cdk.Token (optional)
deviceIndex

SpotFleetResource.InstanceNetworkInterfaceSpecificationProperty.DeviceIndex

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-networkinterfaces.html#cfn-ec2-spotfleet-instancenetworkinterfacespecification-deviceindex

Type:number or @aws-cdk/cdk.Token (optional)
groups

SpotFleetResource.InstanceNetworkInterfaceSpecificationProperty.Groups

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-networkinterfaces.html#cfn-ec2-spotfleet-instancenetworkinterfacespecification-groups

Type:@aws-cdk/cdk.Token or (string or @aws-cdk/cdk.Token)[] (optional)
ipv6AddressCount

SpotFleetResource.InstanceNetworkInterfaceSpecificationProperty.Ipv6AddressCount

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-networkinterfaces.html#cfn-ec2-spotfleet-instancenetworkinterfacespecification-ipv6addresscount

Type:number or @aws-cdk/cdk.Token (optional)
ipv6Addresses

SpotFleetResource.InstanceNetworkInterfaceSpecificationProperty.Ipv6Addresses

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-networkinterfaces.html#cfn-ec2-spotfleet-instancenetworkinterfacespecification-ipv6addresses

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or InstanceIpv6AddressProperty)[] (optional)
networkInterfaceId

SpotFleetResource.InstanceNetworkInterfaceSpecificationProperty.NetworkInterfaceId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-networkinterfaces.html#cfn-ec2-spotfleet-instancenetworkinterfacespecification-networkinterfaceid

Type:string or @aws-cdk/cdk.Token (optional)
privateIpAddresses

SpotFleetResource.InstanceNetworkInterfaceSpecificationProperty.PrivateIpAddresses

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-networkinterfaces.html#cfn-ec2-spotfleet-instancenetworkinterfacespecification-privateipaddresses

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or PrivateIpAddressSpecificationProperty)[] (optional)
secondaryPrivateIpAddressCount

SpotFleetResource.InstanceNetworkInterfaceSpecificationProperty.SecondaryPrivateIpAddressCount

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-networkinterfaces.html#cfn-ec2-spotfleet-instancenetworkinterfacespecification-secondaryprivateipaddresscount

Type:number or @aws-cdk/cdk.Token (optional)
subnetId

SpotFleetResource.InstanceNetworkInterfaceSpecificationProperty.SubnetId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-networkinterfaces.html#cfn-ec2-spotfleet-instancenetworkinterfacespecification-subnetid

Type:string or @aws-cdk/cdk.Token (optional)
class LaunchTemplateConfigProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SpotFleetResource.LaunchTemplateConfigProperty;
// cloudformation.SpotFleetResource.LaunchTemplateConfigProperty is an interface
import { cloudformation.SpotFleetResource.LaunchTemplateConfigProperty } from '@aws-cdk/aws-ec2';
launchTemplateSpecification

SpotFleetResource.LaunchTemplateConfigProperty.LaunchTemplateSpecification

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-launchtemplateconfig.html#cfn-ec2-spotfleet-launchtemplateconfig-launchtemplatespecification

Type:@aws-cdk/cdk.Token or FleetLaunchTemplateSpecificationProperty (optional)
overrides

SpotFleetResource.LaunchTemplateConfigProperty.Overrides

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-launchtemplateconfig.html#cfn-ec2-spotfleet-launchtemplateconfig-overrides

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or LaunchTemplateOverridesProperty)[] (optional)
class LaunchTemplateOverridesProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SpotFleetResource.LaunchTemplateOverridesProperty;
// cloudformation.SpotFleetResource.LaunchTemplateOverridesProperty is an interface
import { cloudformation.SpotFleetResource.LaunchTemplateOverridesProperty } from '@aws-cdk/aws-ec2';
availabilityZone

SpotFleetResource.LaunchTemplateOverridesProperty.AvailabilityZone

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-launchtemplateoverrides.html#cfn-ec2-spotfleet-launchtemplateoverrides-availabilityzone

Type:string or @aws-cdk/cdk.Token (optional)
instanceType

SpotFleetResource.LaunchTemplateOverridesProperty.InstanceType

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-launchtemplateoverrides.html#cfn-ec2-spotfleet-launchtemplateoverrides-instancetype

Type:string or @aws-cdk/cdk.Token (optional)
spotPrice

SpotFleetResource.LaunchTemplateOverridesProperty.SpotPrice

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-launchtemplateoverrides.html#cfn-ec2-spotfleet-launchtemplateoverrides-spotprice

Type:string or @aws-cdk/cdk.Token (optional)
subnetId

SpotFleetResource.LaunchTemplateOverridesProperty.SubnetId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-launchtemplateoverrides.html#cfn-ec2-spotfleet-launchtemplateoverrides-subnetid

Type:string or @aws-cdk/cdk.Token (optional)
weightedCapacity

SpotFleetResource.LaunchTemplateOverridesProperty.WeightedCapacity

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-launchtemplateoverrides.html#cfn-ec2-spotfleet-launchtemplateoverrides-weightedcapacity

Type:number or @aws-cdk/cdk.Token (optional)
class LoadBalancersConfigProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SpotFleetResource.LoadBalancersConfigProperty;
// cloudformation.SpotFleetResource.LoadBalancersConfigProperty is an interface
import { cloudformation.SpotFleetResource.LoadBalancersConfigProperty } from '@aws-cdk/aws-ec2';
classicLoadBalancersConfig

SpotFleetResource.LoadBalancersConfigProperty.ClassicLoadBalancersConfig

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-loadbalancersconfig.html#cfn-ec2-spotfleet-loadbalancersconfig-classicloadbalancersconfig

Type:@aws-cdk/cdk.Token or ClassicLoadBalancersConfigProperty (optional)
targetGroupsConfig

SpotFleetResource.LoadBalancersConfigProperty.TargetGroupsConfig

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-loadbalancersconfig.html#cfn-ec2-spotfleet-loadbalancersconfig-targetgroupsconfig

Type:@aws-cdk/cdk.Token or TargetGroupsConfigProperty (optional)
class PrivateIpAddressSpecificationProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SpotFleetResource.PrivateIpAddressSpecificationProperty;
// cloudformation.SpotFleetResource.PrivateIpAddressSpecificationProperty is an interface
import { cloudformation.SpotFleetResource.PrivateIpAddressSpecificationProperty } from '@aws-cdk/aws-ec2';
privateIpAddress

SpotFleetResource.PrivateIpAddressSpecificationProperty.PrivateIpAddress

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-networkinterfaces-privateipaddresses.html#cfn-ec2-spotfleet-privateipaddressspecification-privateipaddress

Type:string or @aws-cdk/cdk.Token
primary

SpotFleetResource.PrivateIpAddressSpecificationProperty.Primary

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-networkinterfaces-privateipaddresses.html#cfn-ec2-spotfleet-privateipaddressspecification-primary

Type:boolean or @aws-cdk/cdk.Token (optional)
class SpotFleetLaunchSpecificationProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SpotFleetResource.SpotFleetLaunchSpecificationProperty;
// cloudformation.SpotFleetResource.SpotFleetLaunchSpecificationProperty is an interface
import { cloudformation.SpotFleetResource.SpotFleetLaunchSpecificationProperty } from '@aws-cdk/aws-ec2';
imageId

SpotFleetResource.SpotFleetLaunchSpecificationProperty.ImageId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications.html#cfn-ec2-spotfleet-spotfleetlaunchspecification-imageid

Type:string or @aws-cdk/cdk.Token
instanceType

SpotFleetResource.SpotFleetLaunchSpecificationProperty.InstanceType

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications.html#cfn-ec2-spotfleet-spotfleetlaunchspecification-instancetype

Type:string or @aws-cdk/cdk.Token
blockDeviceMappings

SpotFleetResource.SpotFleetLaunchSpecificationProperty.BlockDeviceMappings

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications.html#cfn-ec2-spotfleet-spotfleetlaunchspecification-blockdevicemappings

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or BlockDeviceMappingProperty)[] (optional)
ebsOptimized

SpotFleetResource.SpotFleetLaunchSpecificationProperty.EbsOptimized

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications.html#cfn-ec2-spotfleet-spotfleetlaunchspecification-ebsoptimized

Type:boolean or @aws-cdk/cdk.Token (optional)
iamInstanceProfile

SpotFleetResource.SpotFleetLaunchSpecificationProperty.IamInstanceProfile

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications.html#cfn-ec2-spotfleet-spotfleetlaunchspecification-iaminstanceprofile

Type:@aws-cdk/cdk.Token or IamInstanceProfileSpecificationProperty (optional)
kernelId

SpotFleetResource.SpotFleetLaunchSpecificationProperty.KernelId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications.html#cfn-ec2-spotfleet-spotfleetlaunchspecification-kernelid

Type:string or @aws-cdk/cdk.Token (optional)
keyName

SpotFleetResource.SpotFleetLaunchSpecificationProperty.KeyName

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications.html#cfn-ec2-spotfleet-spotfleetlaunchspecification-keyname

Type:string or @aws-cdk/cdk.Token (optional)
monitoring

SpotFleetResource.SpotFleetLaunchSpecificationProperty.Monitoring

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications.html#cfn-ec2-spotfleet-spotfleetlaunchspecification-monitoring

Type:@aws-cdk/cdk.Token or SpotFleetMonitoringProperty (optional)
networkInterfaces

SpotFleetResource.SpotFleetLaunchSpecificationProperty.NetworkInterfaces

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications.html#cfn-ec2-spotfleet-spotfleetlaunchspecification-networkinterfaces

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or InstanceNetworkInterfaceSpecificationProperty)[] (optional)
placement

SpotFleetResource.SpotFleetLaunchSpecificationProperty.Placement

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications.html#cfn-ec2-spotfleet-spotfleetlaunchspecification-placement

Type:@aws-cdk/cdk.Token or SpotPlacementProperty (optional)
ramdiskId

SpotFleetResource.SpotFleetLaunchSpecificationProperty.RamdiskId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications.html#cfn-ec2-spotfleet-spotfleetlaunchspecification-ramdiskid

Type:string or @aws-cdk/cdk.Token (optional)
securityGroups

SpotFleetResource.SpotFleetLaunchSpecificationProperty.SecurityGroups

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications.html#cfn-ec2-spotfleet-spotfleetlaunchspecification-securitygroups

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or GroupIdentifierProperty)[] (optional)
spotPrice

SpotFleetResource.SpotFleetLaunchSpecificationProperty.SpotPrice

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications.html#cfn-ec2-spotfleet-spotfleetlaunchspecification-spotprice

Type:string or @aws-cdk/cdk.Token (optional)
subnetId

SpotFleetResource.SpotFleetLaunchSpecificationProperty.SubnetId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications.html#cfn-ec2-spotfleet-spotfleetlaunchspecification-subnetid

Type:string or @aws-cdk/cdk.Token (optional)
tagSpecifications

SpotFleetResource.SpotFleetLaunchSpecificationProperty.TagSpecifications

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications.html#cfn-ec2-spotfleet-spotfleetlaunchspecification-tagspecifications

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or SpotFleetTagSpecificationProperty)[] (optional)
userData

SpotFleetResource.SpotFleetLaunchSpecificationProperty.UserData

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications.html#cfn-ec2-spotfleet-spotfleetlaunchspecification-userdata

Type:string or @aws-cdk/cdk.Token (optional)
weightedCapacity

SpotFleetResource.SpotFleetLaunchSpecificationProperty.WeightedCapacity

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications.html#cfn-ec2-spotfleet-spotfleetlaunchspecification-weightedcapacity

Type:number or @aws-cdk/cdk.Token (optional)
class SpotFleetMonitoringProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SpotFleetResource.SpotFleetMonitoringProperty;
// cloudformation.SpotFleetResource.SpotFleetMonitoringProperty is an interface
import { cloudformation.SpotFleetResource.SpotFleetMonitoringProperty } from '@aws-cdk/aws-ec2';
enabled

SpotFleetResource.SpotFleetMonitoringProperty.Enabled

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-monitoring.html#cfn-ec2-spotfleet-spotfleetmonitoring-enabled

Type:boolean or @aws-cdk/cdk.Token (optional)
class SpotFleetRequestConfigDataProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SpotFleetResource.SpotFleetRequestConfigDataProperty;
// cloudformation.SpotFleetResource.SpotFleetRequestConfigDataProperty is an interface
import { cloudformation.SpotFleetResource.SpotFleetRequestConfigDataProperty } from '@aws-cdk/aws-ec2';
iamFleetRole

SpotFleetResource.SpotFleetRequestConfigDataProperty.IamFleetRole

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata.html#cfn-ec2-spotfleet-spotfleetrequestconfigdata-iamfleetrole

Type:string or @aws-cdk/cdk.Token
targetCapacity

SpotFleetResource.SpotFleetRequestConfigDataProperty.TargetCapacity

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata.html#cfn-ec2-spotfleet-spotfleetrequestconfigdata-targetcapacity

Type:number or @aws-cdk/cdk.Token
allocationStrategy

SpotFleetResource.SpotFleetRequestConfigDataProperty.AllocationStrategy

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata.html#cfn-ec2-spotfleet-spotfleetrequestconfigdata-allocationstrategy

Type:string or @aws-cdk/cdk.Token (optional)
excessCapacityTerminationPolicy

SpotFleetResource.SpotFleetRequestConfigDataProperty.ExcessCapacityTerminationPolicy

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata.html#cfn-ec2-spotfleet-spotfleetrequestconfigdata-excesscapacityterminationpolicy

Type:string or @aws-cdk/cdk.Token (optional)
instanceInterruptionBehavior

SpotFleetResource.SpotFleetRequestConfigDataProperty.InstanceInterruptionBehavior

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata.html#cfn-ec2-spotfleet-spotfleetrequestconfigdata-instanceinterruptionbehavior

Type:string or @aws-cdk/cdk.Token (optional)
launchSpecifications

SpotFleetResource.SpotFleetRequestConfigDataProperty.LaunchSpecifications

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata.html#cfn-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or SpotFleetLaunchSpecificationProperty)[] (optional)
launchTemplateConfigs

SpotFleetResource.SpotFleetRequestConfigDataProperty.LaunchTemplateConfigs

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata.html#cfn-ec2-spotfleet-spotfleetrequestconfigdata-launchtemplateconfigs

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or LaunchTemplateConfigProperty)[] (optional)
loadBalancersConfig

SpotFleetResource.SpotFleetRequestConfigDataProperty.LoadBalancersConfig

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata.html#cfn-ec2-spotfleet-spotfleetrequestconfigdata-loadbalancersconfig

Type:@aws-cdk/cdk.Token or LoadBalancersConfigProperty (optional)
replaceUnhealthyInstances

SpotFleetResource.SpotFleetRequestConfigDataProperty.ReplaceUnhealthyInstances

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata.html#cfn-ec2-spotfleet-spotfleetrequestconfigdata-replaceunhealthyinstances

Type:boolean or @aws-cdk/cdk.Token (optional)
spotPrice

SpotFleetResource.SpotFleetRequestConfigDataProperty.SpotPrice

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata.html#cfn-ec2-spotfleet-spotfleetrequestconfigdata-spotprice

Type:string or @aws-cdk/cdk.Token (optional)
terminateInstancesWithExpiration

SpotFleetResource.SpotFleetRequestConfigDataProperty.TerminateInstancesWithExpiration

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata.html#cfn-ec2-spotfleet-spotfleetrequestconfigdata-terminateinstanceswithexpiration

Type:boolean or @aws-cdk/cdk.Token (optional)
type

SpotFleetResource.SpotFleetRequestConfigDataProperty.Type

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata.html#cfn-ec2-spotfleet-spotfleetrequestconfigdata-type

Type:string or @aws-cdk/cdk.Token (optional)
validFrom

SpotFleetResource.SpotFleetRequestConfigDataProperty.ValidFrom

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata.html#cfn-ec2-spotfleet-spotfleetrequestconfigdata-validfrom

Type:string or @aws-cdk/cdk.Token (optional)
validUntil

SpotFleetResource.SpotFleetRequestConfigDataProperty.ValidUntil

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata.html#cfn-ec2-spotfleet-spotfleetrequestconfigdata-validuntil

Type:string or @aws-cdk/cdk.Token (optional)
class SpotFleetTagSpecificationProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SpotFleetResource.SpotFleetTagSpecificationProperty;
// cloudformation.SpotFleetResource.SpotFleetTagSpecificationProperty is an interface
import { cloudformation.SpotFleetResource.SpotFleetTagSpecificationProperty } from '@aws-cdk/aws-ec2';
resourceType

SpotFleetResource.SpotFleetTagSpecificationProperty.ResourceType

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-tagspecifications.html#cfn-ec2-spotfleet-spotfleettagspecification-resourcetype

Type:string or @aws-cdk/cdk.Token (optional)
tags

SpotFleetResource.SpotFleetTagSpecificationProperty.Tags

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-tagspecifications.html#cfn-ec2-spotfleet-tags

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or @aws-cdk/cdk.Tag)[] (optional)
class SpotPlacementProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SpotFleetResource.SpotPlacementProperty;
// cloudformation.SpotFleetResource.SpotPlacementProperty is an interface
import { cloudformation.SpotFleetResource.SpotPlacementProperty } from '@aws-cdk/aws-ec2';
availabilityZone

SpotFleetResource.SpotPlacementProperty.AvailabilityZone

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-placement.html#cfn-ec2-spotfleet-spotplacement-availabilityzone

Type:string or @aws-cdk/cdk.Token (optional)
groupName

SpotFleetResource.SpotPlacementProperty.GroupName

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-placement.html#cfn-ec2-spotfleet-spotplacement-groupname

Type:string or @aws-cdk/cdk.Token (optional)
tenancy

SpotFleetResource.SpotPlacementProperty.Tenancy

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-spotfleetrequestconfigdata-launchspecifications-placement.html#cfn-ec2-spotfleet-spotplacement-tenancy

Type:string or @aws-cdk/cdk.Token (optional)
class TargetGroupProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SpotFleetResource.TargetGroupProperty;
// cloudformation.SpotFleetResource.TargetGroupProperty is an interface
import { cloudformation.SpotFleetResource.TargetGroupProperty } from '@aws-cdk/aws-ec2';
arn

SpotFleetResource.TargetGroupProperty.Arn

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-targetgroup.html#cfn-ec2-spotfleet-targetgroup-arn

Type:string or @aws-cdk/cdk.Token
class TargetGroupsConfigProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SpotFleetResource.TargetGroupsConfigProperty;
// cloudformation.SpotFleetResource.TargetGroupsConfigProperty is an interface
import { cloudformation.SpotFleetResource.TargetGroupsConfigProperty } from '@aws-cdk/aws-ec2';
targetGroups

SpotFleetResource.TargetGroupsConfigProperty.TargetGroups

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-spotfleet-targetgroupsconfig.html#cfn-ec2-spotfleet-targetgroupsconfig-targetgroups

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or TargetGroupProperty)[]
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

SpotFleetResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.SpotFleetResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SpotFleetResourceProps;
// cloudformation.SpotFleetResourceProps is an interface
import { cloudformation.SpotFleetResourceProps } from '@aws-cdk/aws-ec2';
spotFleetRequestConfigData

AWS::EC2::SpotFleet.SpotFleetRequestConfigData

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-spotfleet.html#cfn-ec2-spotfleet-spotfleetrequestconfigdata

Type:@aws-cdk/cdk.Token or SpotFleetRequestConfigDataProperty

SubnetCidrBlockResource

class @aws-cdk/aws-ec2.cloudformation.SubnetCidrBlockResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SubnetCidrBlockResource;
const { cloudformation.SubnetCidrBlockResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.SubnetCidrBlockResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this SubnetCidrBlockResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (SubnetCidrBlockResourceProps) – the properties of this SubnetCidrBlockResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:SubnetCidrBlockResourceProps (readonly)
subnetCidrBlockId
Type:string (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

SubnetCidrBlockResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.SubnetCidrBlockResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SubnetCidrBlockResourceProps;
// cloudformation.SubnetCidrBlockResourceProps is an interface
import { cloudformation.SubnetCidrBlockResourceProps } from '@aws-cdk/aws-ec2';
ipv6CidrBlock

AWS::EC2::SubnetCidrBlock.Ipv6CidrBlock

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-subnetcidrblock.html#cfn-ec2-subnetcidrblock-ipv6cidrblock

Type:string or @aws-cdk/cdk.Token
subnetId

AWS::EC2::SubnetCidrBlock.SubnetId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-subnetcidrblock.html#cfn-ec2-subnetcidrblock-subnetid

Type:string or @aws-cdk/cdk.Token

SubnetNetworkAclAssociationResource

class @aws-cdk/aws-ec2.cloudformation.SubnetNetworkAclAssociationResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SubnetNetworkAclAssociationResource;
const { cloudformation.SubnetNetworkAclAssociationResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.SubnetNetworkAclAssociationResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:SubnetNetworkAclAssociationResourceProps (readonly)
subnetNetworkAclAssociationAssociationId
Type:string (readonly)
subnetNetworkAclAssociationName
Type:string (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

SubnetNetworkAclAssociationResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.SubnetNetworkAclAssociationResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SubnetNetworkAclAssociationResourceProps;
// cloudformation.SubnetNetworkAclAssociationResourceProps is an interface
import { cloudformation.SubnetNetworkAclAssociationResourceProps } from '@aws-cdk/aws-ec2';
networkAclId

AWS::EC2::SubnetNetworkAclAssociation.NetworkAclId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-subnet-network-acl-assoc.html#cfn-ec2-subnetnetworkaclassociation-networkaclid

Type:string or @aws-cdk/cdk.Token
subnetId

AWS::EC2::SubnetNetworkAclAssociation.SubnetId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-subnet-network-acl-assoc.html#cfn-ec2-subnetnetworkaclassociation-associationid

Type:string or @aws-cdk/cdk.Token

SubnetResource

class @aws-cdk/aws-ec2.cloudformation.SubnetResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SubnetResource;
const { cloudformation.SubnetResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.SubnetResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this SubnetResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (SubnetResourceProps) – the properties of this SubnetResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:SubnetResourceProps (readonly)
subnetAvailabilityZone
Type:string (readonly)
subnetId
Type:string (readonly)
subnetIpv6CidrBlocks
Type:SubnetIpv6CidrBlocks (readonly)
subnetNetworkAclAssociationId
Type:string (readonly)
subnetVpcId
Type:string (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

SubnetResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.SubnetResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SubnetResourceProps;
// cloudformation.SubnetResourceProps is an interface
import { cloudformation.SubnetResourceProps } from '@aws-cdk/aws-ec2';
cidrBlock

AWS::EC2::Subnet.CidrBlock

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-subnet.html#cfn-ec2-subnet-cidrblock

Type:string or @aws-cdk/cdk.Token
vpcId

AWS::EC2::Subnet.VpcId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-subnet.html#cfn-awsec2subnet-prop-vpcid

Type:string or @aws-cdk/cdk.Token
assignIpv6AddressOnCreation

AWS::EC2::Subnet.AssignIpv6AddressOnCreation

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-subnet.html#cfn-ec2-subnet-assignipv6addressoncreation

Type:boolean or @aws-cdk/cdk.Token (optional)
availabilityZone

AWS::EC2::Subnet.AvailabilityZone

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-subnet.html#cfn-ec2-subnet-availabilityzone

Type:string or @aws-cdk/cdk.Token (optional)
ipv6CidrBlock

AWS::EC2::Subnet.Ipv6CidrBlock

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-subnet.html#cfn-ec2-subnet-ipv6cidrblock

Type:string or @aws-cdk/cdk.Token (optional)
mapPublicIpOnLaunch

AWS::EC2::Subnet.MapPublicIpOnLaunch

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-subnet.html#cfn-ec2-subnet-mappubliciponlaunch

Type:boolean or @aws-cdk/cdk.Token (optional)
tags

AWS::EC2::Subnet.Tags

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-subnet.html#cfn-ec2-subnet-tags

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or @aws-cdk/cdk.Tag)[] (optional)

SubnetRouteTableAssociationResource

class @aws-cdk/aws-ec2.cloudformation.SubnetRouteTableAssociationResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SubnetRouteTableAssociationResource;
const { cloudformation.SubnetRouteTableAssociationResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.SubnetRouteTableAssociationResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:SubnetRouteTableAssociationResourceProps (readonly)
subnetRouteTableAssociationName
Type:string (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

SubnetRouteTableAssociationResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.SubnetRouteTableAssociationResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.SubnetRouteTableAssociationResourceProps;
// cloudformation.SubnetRouteTableAssociationResourceProps is an interface
import { cloudformation.SubnetRouteTableAssociationResourceProps } from '@aws-cdk/aws-ec2';
routeTableId

AWS::EC2::SubnetRouteTableAssociation.RouteTableId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-subnet-route-table-assoc.html#cfn-ec2-subnetroutetableassociation-routetableid

Type:string or @aws-cdk/cdk.Token
subnetId

AWS::EC2::SubnetRouteTableAssociation.SubnetId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-subnet-route-table-assoc.html#cfn-ec2-subnetroutetableassociation-subnetid

Type:string or @aws-cdk/cdk.Token

TransitGatewayAttachmentResource

class @aws-cdk/aws-ec2.cloudformation.TransitGatewayAttachmentResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.TransitGatewayAttachmentResource;
const { cloudformation.TransitGatewayAttachmentResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.TransitGatewayAttachmentResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:TransitGatewayAttachmentResourceProps (readonly)
transitGatewayAttachmentId
Type:string (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

TransitGatewayAttachmentResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.TransitGatewayAttachmentResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.TransitGatewayAttachmentResourceProps;
// cloudformation.TransitGatewayAttachmentResourceProps is an interface
import { cloudformation.TransitGatewayAttachmentResourceProps } from '@aws-cdk/aws-ec2';
subnetIds

AWS::EC2::TransitGatewayAttachment.SubnetIds

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgatewayattachment.html#cfn-ec2-transitgatewayattachment-subnetids

Type:@aws-cdk/cdk.Token or (string or @aws-cdk/cdk.Token)[]
transitGatewayId

AWS::EC2::TransitGatewayAttachment.TransitGatewayId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgatewayattachment.html#cfn-ec2-transitgatewayattachment-transitgatewayid

Type:string or @aws-cdk/cdk.Token
vpcId

AWS::EC2::TransitGatewayAttachment.VpcId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgatewayattachment.html#cfn-ec2-transitgatewayattachment-vpcid

Type:string or @aws-cdk/cdk.Token
tags

AWS::EC2::TransitGatewayAttachment.Tags

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgatewayattachment.html#cfn-ec2-transitgatewayattachment-tags

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or @aws-cdk/cdk.Tag)[] (optional)

TransitGatewayResource

class @aws-cdk/aws-ec2.cloudformation.TransitGatewayResource(parent, name[, properties])

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.TransitGatewayResource;
const { cloudformation.TransitGatewayResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.TransitGatewayResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this TransitGatewayResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (TransitGatewayResourceProps (optional)) – the properties of this TransitGatewayResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:TransitGatewayResourceProps (readonly)
transitGatewayId
Type:string (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

TransitGatewayResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.TransitGatewayResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.TransitGatewayResourceProps;
// cloudformation.TransitGatewayResourceProps is an interface
import { cloudformation.TransitGatewayResourceProps } from '@aws-cdk/aws-ec2';
amazonSideAsn

AWS::EC2::TransitGateway.AmazonSideAsn

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgateway.html#cfn-ec2-transitgateway-amazonsideasn

Type:number or @aws-cdk/cdk.Token (optional)
autoAcceptSharedAttachments

AWS::EC2::TransitGateway.AutoAcceptSharedAttachments

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgateway.html#cfn-ec2-transitgateway-autoacceptsharedattachments

Type:string or @aws-cdk/cdk.Token (optional)
defaultRouteTableAssociation

AWS::EC2::TransitGateway.DefaultRouteTableAssociation

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgateway.html#cfn-ec2-transitgateway-defaultroutetableassociation

Type:string or @aws-cdk/cdk.Token (optional)
defaultRouteTablePropagation

AWS::EC2::TransitGateway.DefaultRouteTablePropagation

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgateway.html#cfn-ec2-transitgateway-defaultroutetablepropagation

Type:string or @aws-cdk/cdk.Token (optional)
description

AWS::EC2::TransitGateway.Description

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgateway.html#cfn-ec2-transitgateway-description

Type:string or @aws-cdk/cdk.Token (optional)
dnsSupport

AWS::EC2::TransitGateway.DnsSupport

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgateway.html#cfn-ec2-transitgateway-dnssupport

Type:string or @aws-cdk/cdk.Token (optional)
tags

AWS::EC2::TransitGateway.Tags

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgateway.html#cfn-ec2-transitgateway-tags

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or @aws-cdk/cdk.Tag)[] (optional)
vpnEcmpSupport

AWS::EC2::TransitGateway.VpnEcmpSupport

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgateway.html#cfn-ec2-transitgateway-vpnecmpsupport

Type:string or @aws-cdk/cdk.Token (optional)

TransitGatewayRouteResource

class @aws-cdk/aws-ec2.cloudformation.TransitGatewayRouteResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.TransitGatewayRouteResource;
const { cloudformation.TransitGatewayRouteResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.TransitGatewayRouteResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this TransitGatewayRouteResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (TransitGatewayRouteResourceProps) – the properties of this TransitGatewayRouteResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:TransitGatewayRouteResourceProps (readonly)
transitGatewayRouteId
Type:string (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

TransitGatewayRouteResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.TransitGatewayRouteResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.TransitGatewayRouteResourceProps;
// cloudformation.TransitGatewayRouteResourceProps is an interface
import { cloudformation.TransitGatewayRouteResourceProps } from '@aws-cdk/aws-ec2';
transitGatewayRouteTableId

AWS::EC2::TransitGatewayRoute.TransitGatewayRouteTableId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgatewayroute.html#cfn-ec2-transitgatewayroute-transitgatewayroutetableid

Type:string or @aws-cdk/cdk.Token
blackhole

AWS::EC2::TransitGatewayRoute.Blackhole

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgatewayroute.html#cfn-ec2-transitgatewayroute-blackhole

Type:boolean or @aws-cdk/cdk.Token (optional)
destinationCidrBlock

AWS::EC2::TransitGatewayRoute.DestinationCidrBlock

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgatewayroute.html#cfn-ec2-transitgatewayroute-destinationcidrblock

Type:string or @aws-cdk/cdk.Token (optional)
transitGatewayAttachmentId

AWS::EC2::TransitGatewayRoute.TransitGatewayAttachmentId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgatewayroute.html#cfn-ec2-transitgatewayroute-transitgatewayattachmentid

Type:string or @aws-cdk/cdk.Token (optional)

TransitGatewayRouteTableAssociationResource

class @aws-cdk/aws-ec2.cloudformation.TransitGatewayRouteTableAssociationResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.TransitGatewayRouteTableAssociationResource;
const { cloudformation.TransitGatewayRouteTableAssociationResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.TransitGatewayRouteTableAssociationResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:TransitGatewayRouteTableAssociationResourceProps (readonly)
transitGatewayRouteTableAssociationId
Type:string (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

TransitGatewayRouteTableAssociationResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.TransitGatewayRouteTableAssociationResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.TransitGatewayRouteTableAssociationResourceProps;
// cloudformation.TransitGatewayRouteTableAssociationResourceProps is an interface
import { cloudformation.TransitGatewayRouteTableAssociationResourceProps } from '@aws-cdk/aws-ec2';
transitGatewayAttachmentId

AWS::EC2::TransitGatewayRouteTableAssociation.TransitGatewayAttachmentId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgatewayroutetableassociation.html#cfn-ec2-transitgatewayroutetableassociation-transitgatewayattachmentid

Type:string or @aws-cdk/cdk.Token
transitGatewayRouteTableId

AWS::EC2::TransitGatewayRouteTableAssociation.TransitGatewayRouteTableId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgatewayroutetableassociation.html#cfn-ec2-transitgatewayroutetableassociation-transitgatewayroutetableid

Type:string or @aws-cdk/cdk.Token

TransitGatewayRouteTablePropagationResource

class @aws-cdk/aws-ec2.cloudformation.TransitGatewayRouteTablePropagationResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.TransitGatewayRouteTablePropagationResource;
const { cloudformation.TransitGatewayRouteTablePropagationResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.TransitGatewayRouteTablePropagationResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:TransitGatewayRouteTablePropagationResourceProps (readonly)
transitGatewayRouteTablePropagationId
Type:string (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

TransitGatewayRouteTablePropagationResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.TransitGatewayRouteTablePropagationResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.TransitGatewayRouteTablePropagationResourceProps;
// cloudformation.TransitGatewayRouteTablePropagationResourceProps is an interface
import { cloudformation.TransitGatewayRouteTablePropagationResourceProps } from '@aws-cdk/aws-ec2';
transitGatewayAttachmentId

AWS::EC2::TransitGatewayRouteTablePropagation.TransitGatewayAttachmentId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgatewayroutetablepropagation.html#cfn-ec2-transitgatewayroutetablepropagation-transitgatewayattachmentid

Type:string or @aws-cdk/cdk.Token
transitGatewayRouteTableId

AWS::EC2::TransitGatewayRouteTablePropagation.TransitGatewayRouteTableId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgatewayroutetablepropagation.html#cfn-ec2-transitgatewayroutetablepropagation-transitgatewayroutetableid

Type:string or @aws-cdk/cdk.Token

TransitGatewayRouteTableResource

class @aws-cdk/aws-ec2.cloudformation.TransitGatewayRouteTableResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.TransitGatewayRouteTableResource;
const { cloudformation.TransitGatewayRouteTableResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.TransitGatewayRouteTableResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:TransitGatewayRouteTableResourceProps (readonly)
transitGatewayRouteTableId
Type:string (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

TransitGatewayRouteTableResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.TransitGatewayRouteTableResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.TransitGatewayRouteTableResourceProps;
// cloudformation.TransitGatewayRouteTableResourceProps is an interface
import { cloudformation.TransitGatewayRouteTableResourceProps } from '@aws-cdk/aws-ec2';
transitGatewayId

AWS::EC2::TransitGatewayRouteTable.TransitGatewayId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgatewayroutetable.html#cfn-ec2-transitgatewayroutetable-transitgatewayid

Type:string or @aws-cdk/cdk.Token
tags

AWS::EC2::TransitGatewayRouteTable.Tags

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgatewayroutetable.html#cfn-ec2-transitgatewayroutetable-tags

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or @aws-cdk/cdk.Tag)[] (optional)

TrunkInterfaceAssociationResource

class @aws-cdk/aws-ec2.cloudformation.TrunkInterfaceAssociationResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.TrunkInterfaceAssociationResource;
const { cloudformation.TrunkInterfaceAssociationResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.TrunkInterfaceAssociationResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:TrunkInterfaceAssociationResourceProps (readonly)
trunkInterfaceAssociationId
Type:string (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

TrunkInterfaceAssociationResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.TrunkInterfaceAssociationResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.TrunkInterfaceAssociationResourceProps;
// cloudformation.TrunkInterfaceAssociationResourceProps is an interface
import { cloudformation.TrunkInterfaceAssociationResourceProps } from '@aws-cdk/aws-ec2';
branchInterfaceId

AWS::EC2::TrunkInterfaceAssociation.BranchInterfaceId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-trunkinterfaceassociation.html#cfn-ec2-trunkinterfaceassociation-branchinterfaceid

Type:string or @aws-cdk/cdk.Token
trunkInterfaceId

AWS::EC2::TrunkInterfaceAssociation.TrunkInterfaceId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-trunkinterfaceassociation.html#cfn-ec2-trunkinterfaceassociation-trunkinterfaceid

Type:string or @aws-cdk/cdk.Token
greKey

AWS::EC2::TrunkInterfaceAssociation.GREKey

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-trunkinterfaceassociation.html#cfn-ec2-trunkinterfaceassociation-grekey

Type:number or @aws-cdk/cdk.Token (optional)
vlanId

AWS::EC2::TrunkInterfaceAssociation.VLANId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-trunkinterfaceassociation.html#cfn-ec2-trunkinterfaceassociation-vlanid

Type:number or @aws-cdk/cdk.Token (optional)

VPCCidrBlockResource

class @aws-cdk/aws-ec2.cloudformation.VPCCidrBlockResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VPCCidrBlockResource;
const { cloudformation.VPCCidrBlockResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.VPCCidrBlockResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this VPCCidrBlockResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (VPCCidrBlockResourceProps) – the properties of this VPCCidrBlockResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:VPCCidrBlockResourceProps (readonly)
vpcCidrBlockId
Type:string (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

VPCCidrBlockResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.VPCCidrBlockResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VPCCidrBlockResourceProps;
// cloudformation.VPCCidrBlockResourceProps is an interface
import { cloudformation.VPCCidrBlockResourceProps } from '@aws-cdk/aws-ec2';
vpcId

AWS::EC2::VPCCidrBlock.VpcId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpccidrblock.html#cfn-ec2-vpccidrblock-vpcid

Type:string or @aws-cdk/cdk.Token
amazonProvidedIpv6CidrBlock

AWS::EC2::VPCCidrBlock.AmazonProvidedIpv6CidrBlock

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpccidrblock.html#cfn-ec2-vpccidrblock-amazonprovidedipv6cidrblock

Type:boolean or @aws-cdk/cdk.Token (optional)
cidrBlock

AWS::EC2::VPCCidrBlock.CidrBlock

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpccidrblock.html#cfn-ec2-vpccidrblock-cidrblock

Type:string or @aws-cdk/cdk.Token (optional)

VPCDHCPOptionsAssociationResource

class @aws-cdk/aws-ec2.cloudformation.VPCDHCPOptionsAssociationResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VPCDHCPOptionsAssociationResource;
const { cloudformation.VPCDHCPOptionsAssociationResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.VPCDHCPOptionsAssociationResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:VPCDHCPOptionsAssociationResourceProps (readonly)
vpcdhcpOptionsAssociationName
Type:string (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

VPCDHCPOptionsAssociationResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.VPCDHCPOptionsAssociationResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VPCDHCPOptionsAssociationResourceProps;
// cloudformation.VPCDHCPOptionsAssociationResourceProps is an interface
import { cloudformation.VPCDHCPOptionsAssociationResourceProps } from '@aws-cdk/aws-ec2';
dhcpOptionsId

AWS::EC2::VPCDHCPOptionsAssociation.DhcpOptionsId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpc-dhcp-options-assoc.html#cfn-ec2-vpcdhcpoptionsassociation-dhcpoptionsid

Type:string or @aws-cdk/cdk.Token
vpcId

AWS::EC2::VPCDHCPOptionsAssociation.VpcId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpc-dhcp-options-assoc.html#cfn-ec2-vpcdhcpoptionsassociation-vpcid

Type:string or @aws-cdk/cdk.Token

VPCEndpointConnectionNotificationResource

class @aws-cdk/aws-ec2.cloudformation.VPCEndpointConnectionNotificationResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VPCEndpointConnectionNotificationResource;
const { cloudformation.VPCEndpointConnectionNotificationResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.VPCEndpointConnectionNotificationResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:VPCEndpointConnectionNotificationResourceProps (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

VPCEndpointConnectionNotificationResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.VPCEndpointConnectionNotificationResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VPCEndpointConnectionNotificationResourceProps;
// cloudformation.VPCEndpointConnectionNotificationResourceProps is an interface
import { cloudformation.VPCEndpointConnectionNotificationResourceProps } from '@aws-cdk/aws-ec2';
connectionEvents

AWS::EC2::VPCEndpointConnectionNotification.ConnectionEvents

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpcendpointconnectionnotification.html#cfn-ec2-vpcendpointconnectionnotification-connectionevents

Type:@aws-cdk/cdk.Token or (string or @aws-cdk/cdk.Token)[]
connectionNotificationArn

AWS::EC2::VPCEndpointConnectionNotification.ConnectionNotificationArn

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpcendpointconnectionnotification.html#cfn-ec2-vpcendpointconnectionnotification-connectionnotificationarn

Type:string or @aws-cdk/cdk.Token
serviceId

AWS::EC2::VPCEndpointConnectionNotification.ServiceId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpcendpointconnectionnotification.html#cfn-ec2-vpcendpointconnectionnotification-serviceid

Type:string or @aws-cdk/cdk.Token (optional)
vpcEndpointId

AWS::EC2::VPCEndpointConnectionNotification.VPCEndpointId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpcendpointconnectionnotification.html#cfn-ec2-vpcendpointconnectionnotification-vpcendpointid

Type:string or @aws-cdk/cdk.Token (optional)

VPCEndpointResource

class @aws-cdk/aws-ec2.cloudformation.VPCEndpointResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VPCEndpointResource;
const { cloudformation.VPCEndpointResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.VPCEndpointResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this VPCEndpointResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (VPCEndpointResourceProps) – the properties of this VPCEndpointResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:VPCEndpointResourceProps (readonly)
vpcEndpointCreationTimestamp
Type:string (readonly)
vpcEndpointDnsEntries
Type:VPCEndpointDnsEntries (readonly)
vpcEndpointId
Type:string (readonly)
vpcEndpointNetworkInterfaceIds
Type:VPCEndpointNetworkInterfaceIds (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

VPCEndpointResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.VPCEndpointResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VPCEndpointResourceProps;
// cloudformation.VPCEndpointResourceProps is an interface
import { cloudformation.VPCEndpointResourceProps } from '@aws-cdk/aws-ec2';
serviceName

AWS::EC2::VPCEndpoint.ServiceName

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpcendpoint.html#cfn-ec2-vpcendpoint-servicename

Type:string or @aws-cdk/cdk.Token
vpcId

AWS::EC2::VPCEndpoint.VpcId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpcendpoint.html#cfn-ec2-vpcendpoint-vpcid

Type:string or @aws-cdk/cdk.Token
policyDocument

AWS::EC2::VPCEndpoint.PolicyDocument

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpcendpoint.html#cfn-ec2-vpcendpoint-policydocument

Type:json or @aws-cdk/cdk.Token (optional)
privateDnsEnabled

AWS::EC2::VPCEndpoint.PrivateDnsEnabled

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpcendpoint.html#cfn-ec2-vpcendpoint-privatednsenabled

Type:boolean or @aws-cdk/cdk.Token (optional)
routeTableIds

AWS::EC2::VPCEndpoint.RouteTableIds

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpcendpoint.html#cfn-ec2-vpcendpoint-routetableids

Type:@aws-cdk/cdk.Token or (string or @aws-cdk/cdk.Token)[] (optional)
securityGroupIds

AWS::EC2::VPCEndpoint.SecurityGroupIds

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpcendpoint.html#cfn-ec2-vpcendpoint-securitygroupids

Type:@aws-cdk/cdk.Token or (string or @aws-cdk/cdk.Token)[] (optional)
subnetIds

AWS::EC2::VPCEndpoint.SubnetIds

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpcendpoint.html#cfn-ec2-vpcendpoint-subnetids

Type:@aws-cdk/cdk.Token or (string or @aws-cdk/cdk.Token)[] (optional)
vpcEndpointType

AWS::EC2::VPCEndpoint.VpcEndpointType

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpcendpoint.html#cfn-ec2-vpcendpoint-vpcendpointtype

Type:string or @aws-cdk/cdk.Token (optional)

VPCEndpointServicePermissionsResource

class @aws-cdk/aws-ec2.cloudformation.VPCEndpointServicePermissionsResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VPCEndpointServicePermissionsResource;
const { cloudformation.VPCEndpointServicePermissionsResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.VPCEndpointServicePermissionsResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:VPCEndpointServicePermissionsResourceProps (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

VPCEndpointServicePermissionsResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.VPCEndpointServicePermissionsResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VPCEndpointServicePermissionsResourceProps;
// cloudformation.VPCEndpointServicePermissionsResourceProps is an interface
import { cloudformation.VPCEndpointServicePermissionsResourceProps } from '@aws-cdk/aws-ec2';
serviceId

AWS::EC2::VPCEndpointServicePermissions.ServiceId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpcendpointservicepermissions.html#cfn-ec2-vpcendpointservicepermissions-serviceid

Type:string or @aws-cdk/cdk.Token
allowedPrincipals

AWS::EC2::VPCEndpointServicePermissions.AllowedPrincipals

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpcendpointservicepermissions.html#cfn-ec2-vpcendpointservicepermissions-allowedprincipals

Type:@aws-cdk/cdk.Token or (string or @aws-cdk/cdk.Token)[] (optional)

VPCGatewayAttachmentResource

class @aws-cdk/aws-ec2.cloudformation.VPCGatewayAttachmentResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VPCGatewayAttachmentResource;
const { cloudformation.VPCGatewayAttachmentResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.VPCGatewayAttachmentResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:VPCGatewayAttachmentResourceProps (readonly)
vpcGatewayAttachmentName
Type:string (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

VPCGatewayAttachmentResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.VPCGatewayAttachmentResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VPCGatewayAttachmentResourceProps;
// cloudformation.VPCGatewayAttachmentResourceProps is an interface
import { cloudformation.VPCGatewayAttachmentResourceProps } from '@aws-cdk/aws-ec2';
vpcId

AWS::EC2::VPCGatewayAttachment.VpcId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpc-gateway-attachment.html#cfn-ec2-vpcgatewayattachment-vpcid

Type:string or @aws-cdk/cdk.Token
internetGatewayId

AWS::EC2::VPCGatewayAttachment.InternetGatewayId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpc-gateway-attachment.html#cfn-ec2-vpcgatewayattachment-internetgatewayid

Type:string or @aws-cdk/cdk.Token (optional)
vpnGatewayId

AWS::EC2::VPCGatewayAttachment.VpnGatewayId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpc-gateway-attachment.html#cfn-ec2-vpcgatewayattachment-vpngatewayid

Type:string or @aws-cdk/cdk.Token (optional)

VPCPeeringConnectionResource

class @aws-cdk/aws-ec2.cloudformation.VPCPeeringConnectionResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VPCPeeringConnectionResource;
const { cloudformation.VPCPeeringConnectionResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.VPCPeeringConnectionResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:VPCPeeringConnectionResourceProps (readonly)
vpcPeeringConnectionName
Type:string (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

VPCPeeringConnectionResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.VPCPeeringConnectionResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VPCPeeringConnectionResourceProps;
// cloudformation.VPCPeeringConnectionResourceProps is an interface
import { cloudformation.VPCPeeringConnectionResourceProps } from '@aws-cdk/aws-ec2';
peerVpcId

AWS::EC2::VPCPeeringConnection.PeerVpcId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpcpeeringconnection.html#cfn-ec2-vpcpeeringconnection-peervpcid

Type:string or @aws-cdk/cdk.Token
vpcId

AWS::EC2::VPCPeeringConnection.VpcId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpcpeeringconnection.html#cfn-ec2-vpcpeeringconnection-vpcid

Type:string or @aws-cdk/cdk.Token
peerOwnerId

AWS::EC2::VPCPeeringConnection.PeerOwnerId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpcpeeringconnection.html#cfn-ec2-vpcpeeringconnection-peerownerid

Type:string or @aws-cdk/cdk.Token (optional)
peerRegion

AWS::EC2::VPCPeeringConnection.PeerRegion

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpcpeeringconnection.html#cfn-ec2-vpcpeeringconnection-peerregion

Type:string or @aws-cdk/cdk.Token (optional)
peerRoleArn

AWS::EC2::VPCPeeringConnection.PeerRoleArn

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpcpeeringconnection.html#cfn-ec2-vpcpeeringconnection-peerrolearn

Type:string or @aws-cdk/cdk.Token (optional)
tags

AWS::EC2::VPCPeeringConnection.Tags

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpcpeeringconnection.html#cfn-ec2-vpcpeeringconnection-tags

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or @aws-cdk/cdk.Tag)[] (optional)

VPCResource

class @aws-cdk/aws-ec2.cloudformation.VPCResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VPCResource;
const { cloudformation.VPCResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.VPCResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this VPCResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (VPCResourceProps) – the properties of this VPCResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:VPCResourceProps (readonly)
vpcCidrBlock
Type:string (readonly)
vpcCidrBlockAssociations
Type:VPCCidrBlockAssociations (readonly)
vpcDefaultNetworkAcl
Type:string (readonly)
vpcDefaultSecurityGroup
Type:string (readonly)
vpcId
Type:string (readonly)
vpcIpv6CidrBlocks
Type:VPCIpv6CidrBlocks (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

VPCResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.VPCResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VPCResourceProps;
// cloudformation.VPCResourceProps is an interface
import { cloudformation.VPCResourceProps } from '@aws-cdk/aws-ec2';
cidrBlock

AWS::EC2::VPC.CidrBlock

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpc.html#cfn-aws-ec2-vpc-cidrblock

Type:string or @aws-cdk/cdk.Token
enableDnsHostnames

AWS::EC2::VPC.EnableDnsHostnames

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpc.html#cfn-aws-ec2-vpc-EnableDnsHostnames

Type:boolean or @aws-cdk/cdk.Token (optional)
enableDnsSupport

AWS::EC2::VPC.EnableDnsSupport

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpc.html#cfn-aws-ec2-vpc-EnableDnsSupport

Type:boolean or @aws-cdk/cdk.Token (optional)
instanceTenancy

AWS::EC2::VPC.InstanceTenancy

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpc.html#cfn-aws-ec2-vpc-instancetenancy

Type:string or @aws-cdk/cdk.Token (optional)
tags

AWS::EC2::VPC.Tags

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpc.html#cfn-aws-ec2-vpc-tags

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or @aws-cdk/cdk.Tag)[] (optional)

VPNConnectionResource

class @aws-cdk/aws-ec2.cloudformation.VPNConnectionResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VPNConnectionResource;
const { cloudformation.VPNConnectionResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.VPNConnectionResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this VPNConnectionResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (VPNConnectionResourceProps) – the properties of this VPNConnectionResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:VPNConnectionResourceProps (readonly)
vpnConnectionName
Type:string (readonly)
class VpnTunnelOptionsSpecificationProperty

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VPNConnectionResource.VpnTunnelOptionsSpecificationProperty;
// cloudformation.VPNConnectionResource.VpnTunnelOptionsSpecificationProperty is an interface
import { cloudformation.VPNConnectionResource.VpnTunnelOptionsSpecificationProperty } from '@aws-cdk/aws-ec2';
preSharedKey

VPNConnectionResource.VpnTunnelOptionsSpecificationProperty.PreSharedKey

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-vpntunneloptionsspecification.html#cfn-ec2-vpnconnection-vpntunneloptionsspecification-presharedkey

Type:string or @aws-cdk/cdk.Token (optional)
tunnelInsideCidr

VPNConnectionResource.VpnTunnelOptionsSpecificationProperty.TunnelInsideCidr

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-vpntunneloptionsspecification.html#cfn-ec2-vpnconnection-vpntunneloptionsspecification-tunnelinsidecidr

Type:string or @aws-cdk/cdk.Token (optional)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

VPNConnectionResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.VPNConnectionResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VPNConnectionResourceProps;
// cloudformation.VPNConnectionResourceProps is an interface
import { cloudformation.VPNConnectionResourceProps } from '@aws-cdk/aws-ec2';
customerGatewayId

AWS::EC2::VPNConnection.CustomerGatewayId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpn-connection.html#cfn-ec2-vpnconnection-customergatewayid

Type:string or @aws-cdk/cdk.Token
type

AWS::EC2::VPNConnection.Type

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpn-connection.html#cfn-ec2-vpnconnection-type

Type:string or @aws-cdk/cdk.Token
vpnGatewayId

AWS::EC2::VPNConnection.VpnGatewayId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpn-connection.html#cfn-ec2-vpnconnection-vpngatewayid

Type:string or @aws-cdk/cdk.Token
staticRoutesOnly

AWS::EC2::VPNConnection.StaticRoutesOnly

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpn-connection.html#cfn-ec2-vpnconnection-StaticRoutesOnly

Type:boolean or @aws-cdk/cdk.Token (optional)
tags

AWS::EC2::VPNConnection.Tags

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpn-connection.html#cfn-ec2-vpnconnection-tags

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or @aws-cdk/cdk.Tag)[] (optional)
vpnTunnelOptionsSpecifications

AWS::EC2::VPNConnection.VpnTunnelOptionsSpecifications

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpn-connection.html#cfn-ec2-vpnconnection-vpntunneloptionsspecifications

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or VpnTunnelOptionsSpecificationProperty)[] (optional)

VPNConnectionRouteResource

class @aws-cdk/aws-ec2.cloudformation.VPNConnectionRouteResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VPNConnectionRouteResource;
const { cloudformation.VPNConnectionRouteResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.VPNConnectionRouteResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this VPNConnectionRouteResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (VPNConnectionRouteResourceProps) – the properties of this VPNConnectionRouteResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:VPNConnectionRouteResourceProps (readonly)
vpnConnectionRouteName
Type:string (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

VPNConnectionRouteResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.VPNConnectionRouteResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VPNConnectionRouteResourceProps;
// cloudformation.VPNConnectionRouteResourceProps is an interface
import { cloudformation.VPNConnectionRouteResourceProps } from '@aws-cdk/aws-ec2';
destinationCidrBlock

AWS::EC2::VPNConnectionRoute.DestinationCidrBlock

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpn-connection-route.html#cfn-ec2-vpnconnectionroute-cidrblock

Type:string or @aws-cdk/cdk.Token
vpnConnectionId

AWS::EC2::VPNConnectionRoute.VpnConnectionId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpn-connection-route.html#cfn-ec2-vpnconnectionroute-connectionid

Type:string or @aws-cdk/cdk.Token

VPNGatewayResource

class @aws-cdk/aws-ec2.cloudformation.VPNGatewayResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VPNGatewayResource;
const { cloudformation.VPNGatewayResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.VPNGatewayResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this VPNGatewayResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (VPNGatewayResourceProps) – the properties of this VPNGatewayResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:VPNGatewayResourceProps (readonly)
vpnGatewayName
Type:string (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

VPNGatewayResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.VPNGatewayResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VPNGatewayResourceProps;
// cloudformation.VPNGatewayResourceProps is an interface
import { cloudformation.VPNGatewayResourceProps } from '@aws-cdk/aws-ec2';
type

AWS::EC2::VPNGateway.Type

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpn-gateway.html#cfn-ec2-vpngateway-type

Type:string or @aws-cdk/cdk.Token
amazonSideAsn

AWS::EC2::VPNGateway.AmazonSideAsn

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpn-gateway.html#cfn-ec2-vpngateway-amazonsideasn

Type:number or @aws-cdk/cdk.Token (optional)
tags

AWS::EC2::VPNGateway.Tags

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpn-gateway.html#cfn-ec2-vpngateway-tags

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or @aws-cdk/cdk.Tag)[] (optional)

VPNGatewayRoutePropagationResource

class @aws-cdk/aws-ec2.cloudformation.VPNGatewayRoutePropagationResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VPNGatewayRoutePropagationResource;
const { cloudformation.VPNGatewayRoutePropagationResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.VPNGatewayRoutePropagationResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:VPNGatewayRoutePropagationResourceProps (readonly)
vpnGatewayRoutePropagationName
Type:string (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

VPNGatewayRoutePropagationResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.VPNGatewayRoutePropagationResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VPNGatewayRoutePropagationResourceProps;
// cloudformation.VPNGatewayRoutePropagationResourceProps is an interface
import { cloudformation.VPNGatewayRoutePropagationResourceProps } from '@aws-cdk/aws-ec2';
routeTableIds

AWS::EC2::VPNGatewayRoutePropagation.RouteTableIds

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpn-gatewayrouteprop.html#cfn-ec2-vpngatewayrouteprop-routetableids

Type:@aws-cdk/cdk.Token or (string or @aws-cdk/cdk.Token)[]
vpnGatewayId

AWS::EC2::VPNGatewayRoutePropagation.VpnGatewayId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpn-gatewayrouteprop.html#cfn-ec2-vpngatewayrouteprop-vpngatewayid

Type:string or @aws-cdk/cdk.Token

VolumeAttachmentResource

class @aws-cdk/aws-ec2.cloudformation.VolumeAttachmentResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VolumeAttachmentResource;
const { cloudformation.VolumeAttachmentResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.VolumeAttachmentResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this VolumeAttachmentResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (VolumeAttachmentResourceProps) – the properties of this VolumeAttachmentResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:VolumeAttachmentResourceProps (readonly)
volumeAttachmentId
Type:string (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

VolumeAttachmentResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.VolumeAttachmentResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VolumeAttachmentResourceProps;
// cloudformation.VolumeAttachmentResourceProps is an interface
import { cloudformation.VolumeAttachmentResourceProps } from '@aws-cdk/aws-ec2';
device

AWS::EC2::VolumeAttachment.Device

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ebs-volumeattachment.html#cfn-ec2-ebs-volumeattachment-device

Type:string or @aws-cdk/cdk.Token
instanceId

AWS::EC2::VolumeAttachment.InstanceId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ebs-volumeattachment.html#cfn-ec2-ebs-volumeattachment-instanceid

Type:string or @aws-cdk/cdk.Token
volumeId

AWS::EC2::VolumeAttachment.VolumeId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ebs-volumeattachment.html#cfn-ec2-ebs-volumeattachment-volumeid

Type:string or @aws-cdk/cdk.Token

VolumeResource

class @aws-cdk/aws-ec2.cloudformation.VolumeResource(parent, name, properties)

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VolumeResource;
const { cloudformation.VolumeResource } = require('@aws-cdk/aws-ec2');
import { cloudformation.VolumeResource } from '@aws-cdk/aws-ec2';
Extends:

@aws-cdk/cdk.Resource

Parameters:
  • parent (@aws-cdk/cdk.Construct) – the cdk.Construct this VolumeResource is a part of
  • name (string) – the name of the resource in the cdk.Construct tree
  • properties (VolumeResourceProps) – the properties of this VolumeResource
renderProperties(properties) → string => any

Overrides @aws-cdk/cdk.Resource.renderProperties()

Protected method

Parameters:properties (any) –
Return type:string => any
resourceTypeName

The CloudFormation resource type name for this resource class.

Type:string (readonly) (static)
propertyOverrides
Type:VolumeResourceProps (readonly)
volumeId
Type:string (readonly)
addChild(child, childName)

Inherited from @aws-cdk/cdk.Construct

Adds a child construct to this node.

Protected method

Parameters:
Returns:

The resolved path part name of the child

addError(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds an { error: <message> } metadata entry to this construct.

The toolkit will fail synthesis when errors are reported.

Parameters:message (string) – The error message.
Return type:@aws-cdk/cdk.Construct
addInfo(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { “aws:cdk:info”: <message> } metadata entry to this construct.

The toolkit will display the info message when apps are synthesized.

Parameters:message (string) – The info message.
Return type:@aws-cdk/cdk.Construct
addMetadata(type, data[, from]) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a metadata entry to this construct.

Entries are arbitrary values and will also include a stack trace to allow tracing back to

the code location for when the entry was added. It can be used, for example, to include source

mapping in CloudFormation templates to improve diagnostics.

Parameters:
  • type (string) – a string denoting the type of metadata
  • data (any) – the value of the metadata (can be a Token). If null/undefined, metadata will not be added.
  • from (any (optional)) – a function under which to restrict the metadata entry’s stack trace (defaults to this.addMetadata)
Return type:

@aws-cdk/cdk.Construct

addWarning(message) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Adds a { warning: <message> } metadata entry to this construct.

The toolkit will display the warning when an app is synthesized, or fail

if run in –strict mode.

Parameters:message (string) – The warning message.
Return type:@aws-cdk/cdk.Construct
ancestors([upTo]) → @aws-cdk/cdk.Construct[]

Inherited from @aws-cdk/cdk.Construct

Return the ancestors (including self) of this Construct up until and excluding the indicated component

Parameters:upTo (@aws-cdk/cdk.Construct (optional)) –
Return type:@aws-cdk/cdk.Construct[]
findChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path

Throws an exception if the descendant is not found.

Parameters:path (string) –
Returns:Child with the given path.
Return type:@aws-cdk/cdk.Construct
getContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieves a value from tree context.

Context is usually initialized at the root, but can be overridden at any point in the tree.

Parameters:key (string) – The context key
Returns:The context value or undefined
Return type:any
lock()

Inherited from @aws-cdk/cdk.Construct

Locks this construct from allowing more children to be added. After this

call, no more children can be added to this construct or to any children.

Protected method

requireContext(key) → any

Inherited from @aws-cdk/cdk.Construct

Retrieve a value from tree-global context

It is an error if the context object is not available.

Parameters:key (string) –
Return type:any
required(props, name) → any

Inherited from @aws-cdk/cdk.Construct

Throws if the props bag doesn’t include the property name.

In the future we can add some type-checking here, maybe even auto-generate during compilation.

Protected method

Parameters:
  • props (any) – The props bag.
  • name (string) – The name of the required property.
Return type:

any

setContext(key, value)

Inherited from @aws-cdk/cdk.Construct

This can be used to set contextual values.

Context must be set before any children are added, since children may consult context info during construction.

If the key already exists, it will be overridden.

Parameters:
  • key (string) – The context key
  • value (any) – The context value
toString() → string

Inherited from @aws-cdk/cdk.Construct

Returns a string representation of this construct.

Return type:string
toTreeString([depth]) → string

Inherited from @aws-cdk/cdk.Construct

Returns a string with a tree representation of this construct and it’s children.

Parameters:depth (number (optional)) –
Return type:string
tryFindChild(path) → @aws-cdk/cdk.Construct

Inherited from @aws-cdk/cdk.Construct

Return a descendant by path, or undefined

Parameters:path (string) –
Returns:a child by path or undefined if not found.
Return type:@aws-cdk/cdk.Construct (optional)
unlock()

Inherited from @aws-cdk/cdk.Construct

Unlocks this costruct and allows mutations (adding children).

Protected method

validate() → string[]

Inherited from @aws-cdk/cdk.Construct

This method can be implemented by derived constructs in order to perform

validation logic. It is called on all constructs before synthesis.

Returns:An array of validation error messages, or an empty array if there the construct is valid.
Return type:string[]
validateTree() → @aws-cdk/cdk.ValidationError[]

Inherited from @aws-cdk/cdk.Construct

Invokes ‘validate’ on all child constructs and then on this construct (depth-first).

Returns:A list of validation errors. If the list is empty, all constructs are valid.
Return type:@aws-cdk/cdk.ValidationError[]
children

Inherited from @aws-cdk/cdk.Construct

All direct children of this construct.

Type:@aws-cdk/cdk.Construct[] (readonly)
id

Inherited from @aws-cdk/cdk.Construct

The local id of the construct.

This id is unique amongst its siblings.

To obtain a tree-global unique id for this construct, use uniqueId.

Type:string (readonly)
locked

Inherited from @aws-cdk/cdk.Construct

Returns true if this construct or any of it’s parent constructs are

locked.

Protected property

Type:boolean (readonly)
metadata

Inherited from @aws-cdk/cdk.Construct

An array of metadata objects associated with this construct.

This can be used, for example, to implement support for deprecation notices, source mapping, etc.

Type:@aws-cdk/cdk.MetadataEntry[] (readonly)
path

Inherited from @aws-cdk/cdk.Construct

The full path of this construct in the tree.

Components are separated by ‘/’.

Type:string (readonly)
uniqueId

Inherited from @aws-cdk/cdk.Construct

A tree-global unique alphanumeric identifier for this construct.

Includes all components of the tree.

Type:string (readonly)
parent

Inherited from @aws-cdk/cdk.Construct

Returns the parent of this node or undefined if this is a root node.

Type:@aws-cdk/cdk.Construct (optional) (readonly)
ref

Inherited from @aws-cdk/cdk.Referenceable

Returns a token to a CloudFormation { Ref } that references this entity based on it’s logical ID.

Type:string (readonly)
addDeletionOverride(path)

Inherited from @aws-cdk/cdk.Resource

Syntactic sugar for addOverride(path, undefined).

Parameters:path (string) – The path of the value to delete
addDependency(*other)

Inherited from @aws-cdk/cdk.Resource

Adds a dependency on another resource.

Parameters:*other (@aws-cdk/cdk.IDependable) – The other resource.
addOverride(path, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to the synthesized CloudFormation resource. To add a

property override, either use addPropertyOverride or prefix path with

“Properties.” (i.e. Properties.TopicName).

Parameters:
  • path (string) – The path of the property, you can use dot notation to override values in complex types. Any intermdediate keys will be created as needed.
  • value (any) – The value. Could be primitive or complex.
addPropertyDeletionOverride(propertyPath)

Inherited from @aws-cdk/cdk.Resource

Adds an override that deletes the value of a property from the resource definition.

Parameters:propertyPath (string) – The path to the property.
addPropertyOverride(propertyPath, value)

Inherited from @aws-cdk/cdk.Resource

Adds an override to a resource property.

Syntactic sugar for addOverride(“Properties.<…>”, value).

Parameters:
  • propertyPath (string) – The path of the property
  • value (any) – The value
getAtt(attributeName) → @aws-cdk/cdk.CloudFormationToken

Inherited from @aws-cdk/cdk.Resource

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility

in case there is no generated attribute.

Parameters:attributeName (string) – The name of the attribute.
Return type:@aws-cdk/cdk.CloudFormationToken
toCloudFormation() → json

Inherited from @aws-cdk/cdk.Resource

Emits CloudFormation for this resource.

Return type:json
options

Inherited from @aws-cdk/cdk.Resource

Options for this resource, such as condition, update policy etc.

Type:@aws-cdk/cdk.ResourceOptions (readonly)
properties

Inherited from @aws-cdk/cdk.Resource

AWS resource properties.

This object is rendered via a call to “renderProperties(this.properties)”.

Protected property

Type:any (readonly)
resourceType

Inherited from @aws-cdk/cdk.Resource

AWS resource type.

Type:string (readonly)
untypedPropertyOverrides

Inherited from @aws-cdk/cdk.Resource

AWS resource property overrides.

During synthesis, the method “renderProperties(this.overrides)” is called

with this object, and merged on top of the output of

“renderProperties(this.properties)”.

Derived classes should expose a strongly-typed version of this object as

a public property called propertyOverrides.

Protected property

Type:any (readonly)
creationStackTrace

Inherited from @aws-cdk/cdk.StackElement

Type:string[] (readonly)
dependencyElements

Inherited from @aws-cdk/cdk.StackElement

Returns the set of all stack elements (resources, parameters, conditions)

that should be added when a resource “depends on” this construct.

Type:@aws-cdk/cdk.IDependable[] (readonly)
logicalId

Inherited from @aws-cdk/cdk.StackElement

The logical ID for this CloudFormation stack element

Type:string (readonly)
stackPath

Inherited from @aws-cdk/cdk.StackElement

Return the path with respect to the stack

Type:string (readonly)
stack

Inherited from @aws-cdk/cdk.StackElement

The stack this Construct has been made a part of

Protected property

Type:@aws-cdk/cdk.Stack

VolumeResourceProps (interface)

class @aws-cdk/aws-ec2.cloudformation.VolumeResourceProps

Language-specific names:

using Amazon.CDK.AWS.EC2;
import software.amazon.awscdk.services.ec2.cloudformation.VolumeResourceProps;
// cloudformation.VolumeResourceProps is an interface
import { cloudformation.VolumeResourceProps } from '@aws-cdk/aws-ec2';
availabilityZone

AWS::EC2::Volume.AvailabilityZone

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ebs-volume.html#cfn-ec2-ebs-volume-availabilityzone

Type:string or @aws-cdk/cdk.Token
autoEnableIo

AWS::EC2::Volume.AutoEnableIO

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ebs-volume.html#cfn-ec2-ebs-volume-autoenableio

Type:boolean or @aws-cdk/cdk.Token (optional)
encrypted

AWS::EC2::Volume.Encrypted

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ebs-volume.html#cfn-ec2-ebs-volume-encrypted

Type:boolean or @aws-cdk/cdk.Token (optional)
iops

AWS::EC2::Volume.Iops

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ebs-volume.html#cfn-ec2-ebs-volume-iops

Type:number or @aws-cdk/cdk.Token (optional)
kmsKeyId

AWS::EC2::Volume.KmsKeyId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ebs-volume.html#cfn-ec2-ebs-volume-kmskeyid

Type:string or @aws-cdk/cdk.Token (optional)
size

AWS::EC2::Volume.Size

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ebs-volume.html#cfn-ec2-ebs-volume-size

Type:number or @aws-cdk/cdk.Token (optional)
snapshotId

AWS::EC2::Volume.SnapshotId

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ebs-volume.html#cfn-ec2-ebs-volume-snapshotid

Type:string or @aws-cdk/cdk.Token (optional)
tags

AWS::EC2::Volume.Tags

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ebs-volume.html#cfn-ec2-ebs-volume-tags

Type:@aws-cdk/cdk.Token or (@aws-cdk/cdk.Token or @aws-cdk/cdk.Tag)[] (optional)
volumeType

AWS::EC2::Volume.VolumeType

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ebs-volume.html#cfn-ec2-ebs-volume-volumetype

Type:string or @aws-cdk/cdk.Token (optional)